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PREFACE 


MANUAL OBJECTIVES 

The SPM-11M-PLUS Reference Manual is a manual describing the 
structure and use of the SPM-LIM-PLUS software supported by 
DIGITAL on RSX-11M-PLUS operating systems. 

INTENDED AUDIENCE 


This manual is for all users of SPM-LIM-PLUS. 


STRUCTURE OF THIS DOCUMENT 

Chapter 1 is an overview of the architecture of SPM-11M-PLUS. 
Chapter 2 describes the components of SPM-11M-PLUS. 

Chapter 3 describes how to use SPM-~11IM-PLUS. 

Chapter 4 describes data collection and reduction procedures. 
Chapter 5 describes how to read the performance report. 
Chapter 6 delineates the resources used by SPM-11M-PLUS. 


Chapter 7 is the usage notes for SPM-11M-PLUS. 


> 


Appendix is a specification of the Hook Records. 


Appendix B specification of the Monitor Parameter Block 


is a 
(MPB). 
Appendix C is a specification of the Information Records. 
Appendix D is a specification of the System Metrics Record. 
Appendix E is a specification of the logfile format. 
Appendix F is a sample performance report. 

Appendix G@ is a sample SMPGEN.CMD procedure. 


Appendix H is a Sample installation. 
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CHAPTER 1 
OVERVIEW OF 
SPM-11M-PLUS 


The Software Performance Monitor (SPM-11M-PLUS) is a software 
instrument used to measure the performance of a computer system 
running the RSX-11M-PLUS operating system. 

SPM-LIM-PLUS is a natural counterpart to RSX-11M-PLUS: while 
RSX-11M-PLUS manages the resources of the computer system, 
SPM-LIM-PLUS remembers how the resources were used over a 
period of time, similar to the way a tape recorder remembers a 
set of sound patterns. Moreover, SPM-11IM-PLUS has the capa- 
bility of “playing back" these recordings of resource usage, so 
an analyst can study how and when the resources were used. 


SPM-11M-PLUS is an event driven performance monitor. As each 
event of interest occurs, the performance monitor is called. 
1.1 RESOURCES 
The key resources of interest are: 

0) CPU 

(0) Main memory 

fe) 1/0 devices 

0 File system 

) Task loader 
Note that a resource can be a hardware resource -- such as the 


CPU, main memory or an I/0 device; or a software resource -- 
such as the file system or the task loader. 
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1.2 USERS 


A user is the entity which uses the resources managed by the 
operating system. We define a user to be an RSX=11IM-PLUS task. 
Of primary concern is the workload the task places on the 
System, that is, how much and for how long the resources are 
used. To describe a task's workload we will define a set of 
metrics for resource usage. 


1.3 RESOURCE MODEL 


Because a number of tasks may concurrently request the use of a 
resource, and only one task may use the resource at a time, a 
queue will form for the resource. A simple queued resource is 


depicted as follows: 
le ee 
: U 


> 


te 
wW 
< 


s 


The vertical bars represent the queued resource requests and 
the square represents the resource. Three intervals are shown 


on the diagram. "“W" denotes the interval during which a task 
is waiting for the resource. "U" denotes an interval when a 
task is using the resource. "S" is the sum of "W" and "U", 


called the service time. 


1.4 EVENTS 
The activity of the RSX-11M-PLUS operating system can be traced 
by defining a set of key events and recording a set of raw 
information associated with each event. The events of interest 
are those which capture the metrics of resource usage. 
For example, we may want to know how long a task waits for the 
disk, how many times it uses the disk and how long it uses the 
disk. The following events are defined to capture the 1/0 
activity: : 

1. Queue 1/0 packet to driver 

2. Driver gets I/0 packet 


3. Driver posts I/0 completion 
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Applied to the queued resource model for the disk, these I/0 
events appear as follows: 


Cpl ene Oe ace 


1 2 3 


The complete set of events defined for RSX-11M-PLUS is 
specified in Appendix A. ; 


1.5 TASK METRICS 


The task metrics quantify the workload that individual tasks 
place on the system. 


The task metrics are computed for all three types of intervals: 
U, Wand S. The performance report will contain a line of task 
metrics for each resource used by the task. The task metrics 
are: 


0) Count 


A simple metric for resource usage is a count of the 
number of times the resource was used during the life 
of a task. For example, if a task does four QIOs to a 
disk, the I/0 request count is four. 


e) Total Time 


Another simple metric is how long the task uses a 
resource. For example, if a task did four QIOs and 
the I/0 requests took 20ms, 60ms, 10ms and 50ms to 
complete, the total usage time would be 140ms. 


(e) % Resident Time 


Also of importance is what percentage the total usage 
time is of the time the task was in memory. For 
example, if the previous task was in memory for one 
second the percentage of resident time spent using the 
disk was 140ms/1000ms *100% = 14%. 
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e) Interval Statistics 


The statistical nature of the usage time is of key 
importance. 


The metrics defined for interval statistics are: 
- Minimum interval 
- Mean (average) interval 
- Maximum interval 
- Coefficient of Variation 


The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval. 


The coefficient of variation is of particular impor- 
tance because it tells whether the data is clustered 
about the mean (small c.v.) or widely scattered about 
the mean (large c.v.). In fact, if the c.v. is large, 
the mean may tell very little about the nature of the 
data, since very small values and very large values 
may combine to produce a mean which is not represen- 
tative of any real value. 


1.6 SYSTEM METRICS 

The task workload metrics defined above are useful for deter- 
mining who is using the system resources and how much each user 
is consuming. 


Also of importance is the performance of the system as a whole. 
To this purpose we define a set of system metrics. 


The system metrics vary as a function of time. To see how a 
given system metric varies with time, histograms are computed 
for the metric. Each histogram describes the per cent usage of 
a resource for one sampling interval. The sampling interval is 
a settable parameter described in Chapter 3, section 3.2.1. 
CPU 
The CPU can be in one of three general states: 

) User 


fe) Kernel (system) 


(e) Idle 
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A useful metric is the per cent of time spent in each state, 
that is: 


fe) % time in user state 
fe) % time in kernel state 
(0) % time in idle state 


This gives us a general picture of how effectively the CPU is 
being utilized (% time in user state + % time in kernel state), 
as well as the overhead imposed by the operating system (% time 
in kernel state). 


Memory 


On RSX-11M-PLUS the memory space is divided into partitions. 
The user can select one system-controlled partition for 
monitoring by SPM-11M-PLUS. The performance monitor will 
compute the per cent of the partition that was in use at the 
end of each sampling interval and print a histogram. 


The user will most commonly select the partition "GEN" for 
monitoring. 


I/0 Devices 


The user can select one I/0 device to be monitored by 
SPM-11M-PLUS for system-wide usage. SPM-1LIM-PLUS will compute 
the percent of time the device was utilized for each sampling 
interval and print a histogram. If the device is mounted 
Files-11, SPM-11M-PLUS will compute the percent disk space in 
use at the end of each sampling interval and print a histogram. 


Primary and Secondary Pool 


The RSX-11M-PLUS system pool contains the dynamically allocated 
data structures used by the executive. SPM-LIM-PLUS will 
compute the per cent of primary pool and the per cent of 
secondary pool that was in use at the end of each sampling 
interval and print a histogram for each. 


Checkpoint file(s) 


SPM-LIM-PLUS will monitor checkpoint files allocated by the ACS 
command. The performance monitor will compute the per cent of 
all active checkpoint file space in use at the end of each 
sampling interval and print a histogram. 


12/81 OVERVIEW OF SPM-11M-PLUS 1-5 


CHAPTER 2 
THE COMPONENTS 
OF SPM-11M-PLUS 


The SPM-11M-PLUS performance monitor consists of two main 
components: the Data Collection Component and the Data 
Reduction Component. The Data Collection Component records the 
resource usage events of the operating system to a logfile; the 
Data Reduction Component reads the logfile and produces a 
performance report suitable for analysis. 


This general architecture is depicted in Figure 1. 


LogFile| ——-——g» | Reduction | —=—=—-—<m | Performance 
Component Component Report 


Figure l 


Data 
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By decoupling the Data Collection Component from the Data 
Reduction Component in time, the performance monitor can 
collect detailed information about a huge number of events, 
albeit in a raw format. The Data Reduction Component can then 
be used to selectively analyze and filter the information in 
the logfile to produce a performance report. This architecture 
shifts the computational aspects of the performance monitor 
from the Data Collection Component to the Data Reduction 
Component. The benefit derived is that the performance monitor 
uses less CPU time, thus minimizing its interference with the 
CPU. The cost is more I/0 activity, which in most systems can 
be directed to a secondary mass storage device not in the path 
of the major stream of I/0 activity. 


2.1 DATA COLLECTION COMPONENT 
The Data Collection Component consists of both software and 
hardware distributed in various places within an RSX-11M-PLUS 
system. 
The basic pieces of the Data Collection Component are: 

) Hooks 

) Hook Dispatcher 

) Hook Routines 

0) Hook Records 

0) KW11-P Clock and Handler 

Oo Hook Buffers 

0 Logfile 

0) Data Collection Task (...COL) 

fe) Termination Task (...TRM) 


) COL Message Task (COLMSG) 


The relationship between these pieces is shown in Figure 2. 
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DATA COLLECTION COMPONENT 


Hook 
Dispatcher 
KW 11=P 
Handler 


- COL TASK 


_ Hook 
Routines 


PARTITION <-> 


Hook eum | LOGFILE 
Record 


Figure 2 


Heuristic Procedure for Data Collection 
At this point a heuristic procedure for data collection will be 


given, although the terms used in the procedure have not been 
precisely defined. 
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When a resource usage event occurs in RSX-11M-PLUS, the corre- 
sponding hook calls the hook dispatcher, which uses the hook ID 
to call the appropriate hook routine. The hook routine 
collects information relevant to the hook and assembles it into 
a hook record, which resides in a hook buffer. When a hook 
buffer is filled with hook records, it is written to the 
logfile. The logfile is closed at the end of the measurement 
interval, and subsequently reopened by the Data Reduction 
Component. It reads the hook records and uses them to derive 
the resource usage metrics and print a performance report. 


The details of these pieces will now be developed more fully. 


Zell Hooks 


A hook is simply an implementation technique for capturing a 
resource usage event. For SPM-11M-PLUS, a hook is implemented 
as a subroutine call inserted at the point in the Operating 
System where the event occurs. The subroutine call passes 
control and one argument, the hook ID, to the hook dispatcher. 
The form of an SPM-11M-PLUS hook is as follows: 


MOV  @#PS,-(SP) 
MOV —« #H$XXXX,-(SP) 
CALL @$HKDSP 


where XXXX is mnemonic identifying the particular hook. A 
complete specification of all hooks is given in Appendix A. 


Zeled Hook Dispatcher 


Hooks are resident within the operating system; their method of 
insertion is addressed in Chapter 3, section 3.1.3. However, 
most of the code and database for the Data Collection Component 
is not resident within the RSX-11M-PLUS executive. 


The bulk of the data collection code is resident in the data 
collection task called COL (taskname is ...COL). The chief 
benefit derived from this design is that only a small amount of 
executive space is used by the performance monitor. 


The purpose of the hook dispatcher is to map and call the hook 
routines which are resident in the COL task. Note that, though 
the hook routines are resident in the task partition for COL, 
they are executed in the context of a directive or interrupt 
service routine. 
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A one word dispatch vector labelled $HKDSP is added to the 
module DRTBL. This word points to an entry point in the hook 
dispatcher. It is the port through which all hooks pass 
control from the RSX-11M-PLUS executive to the Data Collection 
Component of the performance monitor. 


DO <cles3 Hook Routine 


A hook routine copies information which is generally scattered 
about the executive (typically in SYSCM or SYSTB) into a hook 
record which is resident in a static common or dynamic region. 
A timestamp is also recorded in the hook record. 


There are two general types of hooks: task and system. The 
task hooks collect: data relevant to resources used by tasks; 


the system hooks collect data which is system-wide (e.g., % CPU 
time in user, kernel and idle). 


2.1.4 Hook Record 

The information collected at each hook is formatted into a hook 
record. The hook record provides an identical representation 
of a hook's information content both in memory and in the 


logfile. 


Each hook record contains both generic and hook-specific data. 
Generic data applies to all hooks. Generic data consists of: 


fe) Hook ID 

fe) Taskname 

oO Timestamp 

fe) Task's TI (UCB address) 
Hook specific data applies to only one or a small subset of the 
hooks. For example, the H$CDRP (call directive processor) hook 


records the directive ID code as hook-specific data. 


Appendix A specifies the information content of the _ hook 
records. 
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2.1.5 KW11-P Clock and Handler 


For precise performance measurements, SPM-~11M-PLUS needs a high 
speed clock running independent of the RSX-11M-PLUS system 
clock. It is therefore a requirement that a KW11-P clock be 
installed on a machine running SPM-11M-PLUS. This KW11-P clock 
must be in addition to the RSX-11M-PLUS system clock, be it a 
KW11-L or KW11-P. 


The KW11-P is initialized by the COL task to run at 100 kHz 
(10 microsecond ticks) and to interrupt every 65536 ticks 
(approximately every 0.65 second). 


The KW11-P clock time is maintained as as 2 word (32 bit) value 
which, at a rate of 100 kHz, will overflow ina little over 
11 1/2 hours. 


To preclude the possibility of overflow of the KW11-P clock 
time, a maximum measurement interval of 11 1/2 hours has been 
established. The task COL enforces this by setting an 11 1/2 
hour mark-time when activated. If the timer expires, COL will 
stop data collection and exit. 


The clock interrupt handler updates the high order clock time 
located in SYSCM at $PCLKH. The low order clock time is not 
stored in memory; rather, each hook routine copies the current 
contents of the KW11-P clock's count register to the hook 
record directly to get the low order time word. 


2.1.6 Hook Buffer 


Hook records are stored in buffers which are resident in either 
a static common or a dynamic region. When a hook buffer is 
full, the hook routine sets an event flag which signals the COL 
task to write the buffer to the logfile. 

The hook buffers are linked together into a circular list. 
There may be from 2 to 8 buffers in a list, and all the buffers 
must be of the same length. A buffer may be from 256 words to 
4096 words long. 


If the buffers are resident in a static common, the maximum 
$size common which can be used is 4096 words. This limitation 


common. 


If the buffers are resident in a dynamic region, the region can 
be from 512 words to 32K words long. 


12/81 THE COMPONENTS OF SPM-11M-PLUS 2-6 


(ara Logfile 
The logfile contains four types of records: 
fo) Monitor Parameter Block (MPB) 
fe) Information Records 
0) Hook Records 
0 System Metric Records 


See Appendix E for a specification of the logfile. 


Monitor Parameter Block 


The Monitor Parameter Block (MPB) is used by the COL task to 
initialize its measurement parameters. The MPB is formatted as 
an Information Record with record type I$MPB. A detailed 
description of the MPB is given in Appendix B. 


The MPB is generated by a command file called SMPGEN.CMD. See 
Chapter 3, section 3.2.1 for details. 


Information Records 


The Information Records are used to supplement the Hook Records 
in the logfile with system context useful to the Data Reduction 
Component. 


When COL starts up it reads the MPB from the MPB file and 
writes it to the logfile. Following the MPB, COL writes a 
stream of Information Records which contain a number of 
RSX-11IM-PLUS data structures defining the initial system state. 
These data structures are: 

fe) Task Control Block (TCB) 

fe) Partition Control Block (PCB) 

9) Device Control Block (DCB) 

) Unit Control Block (UCB) 
Each data structure is copied to a separate Information Record. 
When COL begins a measurement interval (starts data collec- 
tion), it records the RSX-11M-PLUS system time as well as the 


SPM-11M-PLUS time (KW11-P time) to an Information Record 
(I$TMR). 
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When COL ends a measurement interval (stops data collection) it 
copies the RSX-11M-PLUS system time, SPM-11M-PLUS time, CPU 
time accrued in kernel state and CPU time accrued in idle state 
to an Information Record (I$STM). 


A complete specification of all Information Records is given in 
Appendix C. 


Hook Records 


As each hook point is encountered in the executive, a Hook 
Record is written to the logfile. See section 2.1.4 for 
details. 


System Metrics Record 


At the end of each sample interval, a System Metrics Record is 
written to the logfile. This record contains information which 
describes the system-wide usage of the selected resources. , 


The System Metrics Record is specified in Appendix D. 


Logfile Media 


The logfile can be resident on disk as a Files-11 file or on 
magtape as a sequence of tape records. 


If the logfile is resident on disk, it consists of a sequence 
of virtual blocks (virtual block=256 words). The records 
within these virtual blocks are defined according to the record 
definitions for the MPB, Information Records, Hook Records and 
System Metric Records. Note that the logfile does not have any 
other record structure (such as FCS or RMS type records). 


If the logfile is on a magtape, the MPB, Information Records 
and Hook Records are imbedded in a stream of tape records. 
Each tape record is equal in length to a hook buffer. 


2.1.8 Data Collection Task (...COL) 


This section gives a functional description of the COL task. A 
guide to using COL is provided in Chapter 3, section 3.2.2. 


As noted before, this task contains both code which executes in 
executive context (as a directive or interrupt process) and 
code which executes in the context of a privileged task. The 
code which executes at executive level is the hook routines. 
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2.1.8.1 COL Executive Level Code - 


The hook routines were made a part of the COL task for a number 
of reasons: 


) They must be resident in some partition outside of 
executive space. 


9) They can easily be loaded as part of the COL task. 


Oo They implement routines which are common to hooks and 
to the COL task. 


2512842 COL Task Level Code - 


Most of the COL task consists of code which is executed at task 
level. The major functions of the COL task are: 


0) Initialization 

) Starting data collection 
0) Writing to logfile 

0 Stopping data collection 


) Cleanup 


2.1.8.2.1 Initialization - 


When COL begins execution, there is very little SPM-11M-PLUS 
code elsewhere in the system. All that exists are the hooks in 
the executive which all call a dummy return subroutine in 
TDSCH. It is the job of COL to initialize all code and 
databases required for the SPM-11M-PLUS performance monitor. 
The specific sequence of initialization functions performed by 
COL are: 


0 Read MPB file and store MPB in COL buffer. 

Oo Create dynamic region (if necessary) and set up ring 
of hook buffers. Mark dynamic region or static common 
as fixed and non-shufflable. 


0 Write MPB and Information Records (RSX-11M-PLUS data 
structures) to logfile. 


0) Mark COL task as fixed in memory and nonshufflable. 


) Initialize hooks specified in MPB, 
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0) Initialize KW11-P clock and turn it on. 


fe) Initialize measurement parameters as specified in MPB. 


Zed eSeLid Starting Data Collection - 


When data collection is disabled, the hook dispatch vector 
$HKDSP points to the entry point $HKEXT in the hook 
dispatcher, which simply returns to the instruction in the 
executive following the hook. 


Just prior to starting data collection, COL writes a “start 
data collection" Information Record (I$TMR) to the hook buffer. 


To enable data collection the COL task simply points the hook 
dispatch vector $HKDSP to the entry point $HKENT in the hook 
dispatcher. 


2a he Bsle3 Writing Hook Records to Logfile - 


The steady state function of the COL task is to write Hook 
Records to the logfile. When a hook routine fills a_ hook 
buffer, it sets an event flag for COL which wakes COL from its 
Wait state. COL then writes the hook buffer to disk or magtape 
(waiting for completion of the write), and loops to see if 
another hook buffer is ready to write. When no more _ hook 
buffers are outstanding, COL returns to the wait state. 


If the hook buffers fill up too rapidly for COL to write them 
to the logfile, COL will set the overflow status bit. If the 
overflow status is set when a measurement interval expires, COL 
Will print a status message on the console device (C0O:). In 
general, the data collected during a measurement interval 
should not be used for data reduction if the overflow condition 
occurred. 


2.1.8.2.4 Stopping Data Collection - 


To stop data collection, COL merely points the hook dispatch 
vector $HKDSP to the dummy routine at $HKEXT in the hook 
dispatcher. It then writes a stop data collection Information 
Record (I$STM) to the hook buffer. Any outstanding records in 
the hook buffer will be written to the logfile. 
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201-3802 4:5 Cleanup - 


Before COL exits, it must release any system resources it has 
allocated and deactivate any hardware it has turned on. The 
following actions are thus performed: 


fa) Turn off KW11-P clock. 


a) Unfix COL task. 


2.1.9 Termination Task (...TRM) 


The purpose of the termination task (...TRM) is to signal the 
COL task to stop data collection and exit. TRM provides a way 
to manually terminate the COL task, as opposed to automatic 
shutoff by timeout or buffers (see Chapter 3, section 3.2.1). 


225210 COL Message Task (COLMSG) 


The COL message task contains the ASCII text for the error 
messages issued by the COL task. If the COLMSG task is instal- 
led and a COL error occurs, the full error message text will be 
printed. If a COL error occurs and the COLMSG task is not 
installed, the COL task will print an error number which can be 
correlated with the correct error message in Chapter 3, section 
Oaes Ok 


2.2 DATA REDUCTION COMPONENT 

The main purpose of the Data Reduction Component is to read the 
raw data from the logfile (hook records) and produce a perfor- 
mance report detailing the resources used by the various tasks 
in the system. 


The Data Reduction Component accomplishes this in a multi-step 
process involving two tasks: 


) Monitor Data Reduction (MDR) Task 


(a) DRS Task 
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There are three major steps in the data reduction process; 
1. Map Hook Records to Task Workload Records and generate 
system-wide metrics section of performance report (MDR 
Pass 1). 
2. Sort Task Workload Records (DRS). 
3. Summarize Task Workload Records and generate task 
metrics section of performance report (MDR Pass 2). 


The Task Workload Records are intermediate data structures 
which contain the data collected for each task and. each 
resource used by. the task. 


This general procedure is depicted in Figure 3. 


DATA REDUCTION COMPONENT 


TRACE .LOG 
: eo cmrneee 
Hoo 
| 
RESOURCE. TMP RESOURCE. SRT 
a a 


Per formance 
RESOURCE. SRT ———> MDR s Report 


Figure 3 


RESOURCE. TMP 


Task Workload 
Record 
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From the figure we see there are four databases which are 
processed by the two tasks: 


6) TRACE.LOG (logfile containing Hook Records). 


0 RESOURCE.TMP (intermediate file containing unsorted 
Task Workload Records). 


0) RESOURCE.SRT (intermediate file containing sorted Task 
Workload Records. 


fe) REDUCE.RPT (final performance report). 


2.2.1 MDR Pass 1 


MDR reads hook records from the logfile (default name is 
TRACE.LOG) and maps the information to the Task Workload 
Records in the intermediate file RESOURCE.TMP. 


Zetad DRS Pass 


DRS sorts the Task Workload Records using the following three 
keys: 


fe) Generic Taskname 
) Task's TI UCB address 


) Task start time. 


NOTE: By “generic taskname" we mean the installed taskname of 
a multiuser task. For example, the generic taskname for 
the task PIPT5 is ...PIP. If the task is not multiuser, 
generic taskname is simply the run time taskname. 


The three keys listed above are concatenated into one "big" 
key, with the generic taskname forming the highest order part 
of the key, the Task's TI UCB address forming the middle order 
part of the key, and the Task start time forming the low order 
part of the key. The DRS task sorts all the Task Workload 
Records using this one big key. With this technique the DRS 
task only needs to do one sort operation on the file 
RESOURCE.TMP. 
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When DRS is done sorting the Task Workload Records, the records 
will be arranged as follows: 


0 All records with the same generic taskname will be 
clustered together. 


fe) Within a generic taskname cluster, all records with 
the same TI will be clustered together. 


0 All records within a taskname-TI cluster will be 
sequenced by ascending task start time. 


DRS writes the sorted Task Workload Records to the file 
RESOURCE.SRT. 

2.2.3 MDR Pass 2- 

MDR reads the Task Workload Records from RESOURCE.SRT and 


generates a performance report. A description of the 
performance report is given in Chapter 5. 
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CHAPTER 3 
GUIDE TO USING 
SPM-11M-PLUS_ 


3.1 INSTALLATION 


Seled SPM-1L1M-PLUS Kit 


The SPM-11M-PLUS kit is distributed on 800 BPI magtape. it 
contains all the files necessary to install and uSe 
SPM-11M-PLUS. The files are in DOS tape format. When copied 
to disk, the files will occupy approximately 900 disk blocks. 


The command file PMONCPY.CMD can be used to copy the kit files 
from tape to tape, tape to disk, disk to tape or disk to disk. 
All files are contained in the directory [12,2]. The contents 
of the kit are: 


Component File 

Kit copy command file PMONCPY.CMD 
SPM-11M-PLUS mini-reference guide SPM.DOC 

MPB GEN command file © SMPGEN.CMD 
Macro definition prefix file HKMAC .MAC 
Executive source correction command file PMONSLP.CMD 
Executive source correction files *.COR 
FI1ACP patch command file PMONPAT.CMD 
F11ACP patch source DISPAT.PAT 
COL/TRM build command file PMONBLD.CMD 
COL overlay descriptor file COLBLD.ODL 
COL/TRM object library COL.OLB 
MDR/CLF object library (EIS version) MDREIS.OLB 
MDR/CLF object library (FPP version) MDRFPP.OLB 
MDR/CLF/OVL build command file MDRTKB.CMD 
Data reduction sort task DRS.TSK 

DRS map file DRS.MAP 

DRS sort command file DRS.CMD 

CLF task CLETSK 

CLF map file CLF.MAP 

OVL object library OVL.OLB 

OVL task OVL.TSK 

OVL map file OVL.MAP 
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Sehket Prerequisites to Installing SPM-11M-PLUS 

COL Prerequisites 

The following are the prerequisites for running the COL task: 
f°) Supervisor-mode library support 
fe) The supervisor-mode library FCSFSL must be installed 


fe) Memory Management (PLAS) Directives 


MDR Prerequisites 
All Prerequisites for MDR are included in a_eminimum 
functionality RSX-11M-PLUS system. To run MDR at least one 
system-wide checkpoint file must be allocated using the ACS 
command. For MDR to automatically spawn the task DRS, 
parent-offspring support must be included in. the RSX-11M-PLUS 
executive. 
Dede d Installing SPM-11M-PLUS 
To install SPM-11M-PLUS, you must start with: 

0 An RSX-11M-PLUS V1.0 distribution kit 

) An RSX-11M-PLUS autopatch kit at the current level 

) An SPM-1iM-PLUS distribution kit 
To install SPM-11M-PLUS you must perform an RSX-11M-PLUS 


SYSGEN. A SYSGEN is required because source code for 
SPM-11M-PLUS is inserted into the RSX-11M-PLUS sources. 
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SPM-11M-PLUS source code is added to the following RSX-11M-PLUS 
source modules: 


SPM-11M-PLUS Function RSX-1L1M-PLUS Modules 


SPM-1LIM-PLUS Macros RSXMCO,RSXMC 
and Definitions. 


Hooks DRDSP,DRQIO,DREIF ,DREXP, 


DRGIN,DRTBL ,DRCRV,REQSB, 
SYSXT,ITOSUB ,LOADR 


Additional Stack Space LOWCR 
Common Database SYSCM 
Hook Dispatcher TDSCH 
KW11-P Clock Handler TDSCH 


For a complete example installation procedure, see Appendix H. 


The 
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SPM-1LIM-PLUS installation procedure consists of the 
following steps: 


e) 


0 


Copy RSX-11IM-PLUS Vi.0 kit to baseline'disk. 
Perform autopatch to current level. 


Follow the instructions in the Autopatch notes for 
applying Autopatch. 


Note: to run the Autopatch procedure, you must first 
invoke @[200,200j SYSGEN and answer "yes" to _ the 
following question: 


>* DO YOU WANT TO APPLY AUTOPATCH [Y/N] :Y 


When the Autopatch procedure finishes, control will be 
returned to SYSGEN.CMD. You must then answer "NO" to 
the following three questions: 


>* DO YOU WANT TO DO SYSGEN PART 1 [Y/N] N 
>»* DO YOU WANT TO DO SYSGEN PART 2 [Y/N] N 
>* DO YOU WANT TO DO SYSGEN PART 3 [Y/N] N 
>ASN = 
>@<EQOF> 


When the SYSGEN.CMD procedure exits, continue to the 
next step. 


Assign SY: to the baseline disk. 
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Choose a directory to which you want the SPM-11M-PLUS 
kit files copied. This will be your SPM-1L1IM-PLUS kit 
directory. 


Assuming the SPM-11M-PLUS directory is [g,m], and 
SPM-11M-PLUS kit is physically mounted on device ddn:. 


>SET /UIC=[g ,m] 

>UFD SY :[Eg,m] 

>MOU ddn:/FOR 

>FLX =ddn:[12,2]PMONCPY.CMD 
> @PMONCPY 


APPLY CORRECTIONS TO EXECUTIVE SOURCES? Y 


APPLY PATCH TO F11ACP DISPATCHER MODULE (DISPAT)? Y 
@<EOF> 
>DMO ddn: 

Invoke SYSGEN.CMD a second time 


Invoke @[200,200]SYSGEN.CMD and answer "NO" to the 
following question: 


>* DO YOU WANT TO APPLY AUTOPATCH [Y/N] N 


Then perform a SYSGEN by answering "YES" to the 
following questions: 


>* DO YOU WANT TO DO SYSGEN PART 1 [Y/N] Y 
>* DO YOU WANT TO DO SYSGEN PART 2 [Y/N] Y 
>»* DO YOU WANT TO DO SYSGEN PART 3 [Y/N] Y 
(Note: SYSGEN PART 3 is optional) 


Vo 


NOTE: DO NOT PATCH F11ACP if you want to use the FCPRO3 


version. 


If the patch to FI11ACP fails (checksum error), 
SPM-11M-PLUS will only calculate service times for 
FIIACP. If the patch succeeds, SPM-11M-PLUS will 
generate usage, wait and service times. 
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If you do not elect to correct the executive 
sources or patch F11ACP via PMONCPY.CMD you can do 
so later via the command files: 


1) @PMONSLP for executive source corrections 


2) @PMONPAT for F11ACP patch 


On systems with an FP11 the file MDREIS.OLB is not 
needed and may be deleted. On systems without an 
FPP, the file MDRFPP.OLB is not needed and may be 
deleted. The file may be deleted before starting 


the SYSGEN. 


) When the SYSGEN completes, perform the following 
steps: 


>SET /UIC=[g ,m] 
>@PMONBLD 
NOTE: The command file will pause if you desire to 
edit the build files for CLF, OVL, or MDR. This 
will allow modifications to defaults for these 


programs. Instructions are included in the 
build files. 


You can build the MDR, OVL, or CLF tasks 
separately from PMONBLD.CMD by invoking the 
command file MDRTKB.CMD. 

0) You are now ready to run @SMPGEN to generate an MPB 


and run COL. This procedure is described in the next 
section. 


See OPERATION 


Sata Generating the Monitor Parameter Block (MPB) 


The MPB is the structure which contains the measurement 
parameters. 


To create an MPB you invoke the command file SMPGEN.CMD. 


See Appendix G for an example SMPGEN. 
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The procedure is as follows: 
>SET /UIC=[g ,m] 
>@SMPGEN 
where [g,m] is your SPM-11M-PLUS kit directory. 


The MPB is created in the following way: SMPGEN creates a 
source file (default filespec is TRACE.PAR), assembles and 
builds the code in the file to produce a binary MPB file 
(default filespec is TRACE.MPB). It is this file which is read 
by the data collection task COL to initialize the measurement 
parameters, 


In addition to the files mentioned above, SMPGEN also will 
output, if requested, a saved answer file (default filespec is 
TRACE.CMD). This file can be input to another run of SMPGEN 
and will initialize the symbol table to the values of the 
variables saved in the file. 


SMPGEN is driven from a menu of parameter categories. To 
display the menu, type an <ESC>. The menu appears as: 


LEGAL PARAMETER CATEGORIES ARE 
HOOK TASK MODE LABEL 
BUFFER DEVICE SYSTEM DONE 


we we we we we 


The parameter categories can be specified in any order. If a 
parameter category is not specified, the parameters will] 
receive default values from either: 

fe) The saved answer file, if one is specified. 


) The table of default parameters. 
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Table of Default Parameters 
HOOKS - all hooks enabled, excepting the LOAD 


OVERLAY, CALL DIRECTIVE PROCESSOR and USER 
INFORMATION hooks. 


BUFFERS - DYNAMIC region named TRCPAR created in 
partition GEN, 2 buffers with 8 blocks per 
buffer. 

TASKS - All tasks enabled for data collection. 

DEVICES - All devices enabled for data collection. 

MODE - MANUAL mode. 


SYSTEM - System Metrics enabled with 60 second 
sampling interval. 


LABEL - No label. 


To select a parameter category, enter the name of the parameter 
category desired as shown in the following example: 


ENTER PARAMETER CATEGORY? HOOK 


Once a parameter category is selected, the detailed parameters 
are specified. Each parameter category has a menu of responses 
which are possible for that parameter category. To get the 
menu, type <ESC>. When you are finished entering parameters, 
type "DONE". 


A detailed description of each parameter category follows. 

0) Label Field 
To select the label parameter category, type: LABEL 
The following query will be displayed: 

ENTER MPB LABEL? 

The response may be any string from 0 to 63 characters 
long. This user-definable string is stored in the MPB 
and will typically contain notes and comments appli- 
cable to a particular measurement run. It is printed 


as part of the heading on each page of the performance 
report. 
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Hooks 
To select the hooks parameter category, type: HOOK 


The hooks determine which resource usage events are 
recorded to the logfile. 


You do not select each hook individually. Rather, you 
select one or more groups of hooks. Each group of 
hooks contains the subset of hooks which will generate 
a consistent set of data for measuring the usage of a 
particular resource. Hooks may be chosen from the 
following groups: 


- CPU USAGE HOOKS 

This hook group measures task CPU usage. 

It is required for all metrics for task CPU usage. 
- MEMORY USAGE HOOKS 

This hook group measures task memory usage. 


It is required for all metrics for task memory 
usage and % resident time. 


- 1/0 DEVICE USAGE HOOKS 
This hook group measures task usage of I/0 devices 
and the file system. The file system is regarded 


as any ACP which manages a device. Examples are 
FLIACP and MTAACP., 


This hook group is required for all metrics 
relative to task usage of I/0 devices or the file 
system, 

- LOAD OVERLAY HOOK 


This hook records the relative block number of a 
task's overlay to the logfile. 


- CALL DIRECTIVE PROCESSOR HOOK 


This hook records the directive ID of a directive 
to the logfile. 


- USER INFORMATION HOOK 
This hook is invoked when a task issues a directive 
of the form: GIN$ 7, P1,P2,P3,P4,P5,P6,P7,P8. The 


eight parameters Pl - P8 are written to the 
logfile. 
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Buffers 


To select the buffers parameter category, type: 
BUFFER. 


The hook buffers may be resident in either a static 
common or a dynamic region. The buffer type is 
specified by: 

ENTER BUFFER TYPE? 


The response may be either STATIC indicating a static 
common or DYNAMIC indicating a dynamic region. 


NOTE: If "STATIC" is selected, the COL task must have 
been. linked to a static common in the instal- 
lation phase (see Chapter 3, section 3.1.3). 


If "DYNAMIC" is selected, COL must not be linked 
to the static common. 


If the buffer type is DYNAMIC, the name of the 
system-controlled partition in which to create the 
dynamic region is specified by: 
ENTER NAME OF BUFFER MAIN (SYS) PARTITION? 
The name of the buffer common/region is specified by: 
ENTER NAME OF BUFFER COMMON/REGION? 


The partition will be divided up into a number of hook 


buffers, determined by: 


ENTER NUMBER OF BUFFERS [2. :8. :2.]? 
Note that from 2 to 8 buffers may be specified. 
Finally, the length of each buffer is specified by: 
ENTER BUFFER SIZE IN 512 B BLOCKS? 


A buffer can be from 1 to 16 blocks long; in other 
words, from 256 words to 4096 words long. 


If a static common is used for buffering, the total 
space required for buffers must fit into the common. 
If a dynamic region is used, COL will create a region 
large enough to contain the buffers. 
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Tasks 
SPM-11M-PLUS can be set up to collect data for 
specific tasks. For example, there may be some tasks 
whose performance metrics are not desired at all. 
Typically, system "service" tasks, such as FI11ACP, 
»++MCR and QMG... fall into this category. 
To select the task parameter category, type: TASK. 
The following query will appear: 

DO YOU WANT TO TRACE ALL TASKS? 


If your answer is N, you will be given two choices for 
selecting the tasks for data collection: 


- Specify the tasks not to trace. 
- Specify the tasks to trace. 
The choice is made from the query: 
DO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? 
If the answer is Y, you are prompted with: 
ENTER NAME OF TASK NOT TO TRACE? 
If the answer is N, you are prompted with: 
ENTER NAME OF TASK TO TRACE? 
You then type, one per line, the names of the tasks 
desired or not desired. Each taskname is from 1 to 6 
characters long. To terminate the list of tasks, type 


<CR>. 


Up to 64 tasknames can be specified. 


Devices 


To get the devices parameter category, type: DEVICE. 
SPM-1LIM-PLUS can be set up to collect data for 
specific classes of devices. If you want to collect 
data only for selected classes of devices, answer N to 
the following query: 
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DO YOU WANT TO COLLECT DATA FOR ALL DEVICES? 
A device in RSX-11M-PLUS may fall into one of four 
classes depending on the bit setting of the "Device 
Characteristics Word" U.CWl in the UCB. 
- Directory Device (DV.DIR) 
- Sequential Device (DV.SQD) 
- Terminal Device (DV.TTY) 
- All Other Devices 


To enable data collection for a device class, answer Y 
to the query for that device class. The queries are: 


TRACE DISK (DIRECTORY DEVICE) 1/0 ACTIVITY? 
TRACE TAPE (SEQUENTIAL DEVICE) 1/0 ACTIVITY? 
TRACE TERMINAL I/O ACTIVITY? 


TRACE ALL OTHER DEVICES I/0 ACTIVITY? 


Mode 
To select the mode parameter category, type: MODE. 


The performance monitor can be set up to collect data 
in three different modes. You select the mode by 
answering: 


ENTER MODE? 


The possible modes are: MANUAL, AUTOSTOP and REPEAT. 
Each mode determines the manner in which a measurement 
interval begins and ends. A description of each mode 
follows: 


- Manual 
In manual mode, a measurement interval begins when 


the COL task is invoked and ends when the TRM 
(termination) task is run. 


po 
— 
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Autostop 

In autostop mode, a measurement interval begins 
when the COL task is invoked and ends when either 
of the following two events occur: 

- A mark-time expires. 


- A predetermined number of buffers have been 
filled. 


You determine the type of autostop by responding 
to: 


-ENTER SAMPLING TYPE? 
with either TIME or BUFFER. 


If TIME is specified, you then have to specify the 
timeout interval: 


ENTER SAMPLING INTERVAL TIME UNIT [D:MIN] 
ENTER SAMPLING INTERVAL IN units ? 


where “units" is the time unit specified in the 
previous query. Legal units are SEC, MIN or HR. 


NOTE: Do not confuse this sampling interval with 


the system metrics sampling interval 
described in the next section. 


If BUFFER is specified as the interval type, you 
must specify the number of buffers per sample: 
ENTER NUMBER OF BUFFERS PER SAMPLE? 


Note that each buffer is from 1 to 16 disk blocks 
(256 words) long. 


Repeat 


Repeat mode is autostop mode repeated a number of 
times. The sampling interval is specified as for 
autostop mode. In addition, you must specify: 

- The number of intervals 


- The length of time between intervals. 
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You specify these parameters by answering the 
following queries: 


ENTER MAX. NUMBER OF SAMPLES? 
ENTER INTERVAL BETWEEN SAMPLES TIME UNIT [D :MIN]? 
ENTER INTERVAL BETWEEN SAMPLES IN units ? 


where “units" is the time unit specified in the 
previous query. 


0 System 


To select the system-metrics parameter group, type 
PSS PE Mets 


If you want the system metrics, answer Y the the next 
query: 


DO YOU WANT THE SYSTEM METRICS? [Y/N]: 


If you answered Y, you must then specify the sampling 
interval by: 


ENTER SYSTEM METRICS SAMPLING INTERVAL (SEC) ? 
(0) Done 


When you are finished entering parameters, type 
"DONE". The SMPGEN procedure will then create: 


- A monitor parameter block (MPB) file 
(filename.MPB). 


- A parameter source file (filename.PAR). 
- A saved answer file (filename.CMD, if specified). 
Note: SMPGEN will prompt you for the parameter source 
file and saved answer file, and you must enter 
a valid file specification. 
3.2.2 Using COL 
The COL task is used to initialize the performance monitor, 


start data collection, collect data, stop data collection and 
clean up the performance monitor before exiting. 
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Installing COL 

The COL task can be installed in any partition. If possible, 
create a separate 3.5K word partition for COL. If installed in 
a system-controlled partition, COL will automatically fix 
itself and mark itself as non-shufflable. It is therefore 
desirable to install and run COL when there is little or no 
System activity in the partition in which COL is installed so 
as to load COL in the lower end of the partition and reduce 
fragmentation of the partition. 

COL is taskbuilt with a default priority of 230. Note that COL 
has a higher priority than F11ACP and ...MCR, but a lower pri- 
ority than ...LDR. It is highly recommended that the priority 
of COL not be altered to a value lower than the default value 
of 230, otherwise excessive overflows may occur which will 
invalidate the measurement runs. 


If full ASCII message text output is desired, install the 
COLMSG task. 


If you are using a static common for COL buffers, be sure to 
install it before installing the COL task. 


Install COL and COLMSG by: 
>INS TRCPAR ;ONLY FOR STATIC COMMON 
>INS COL 
>INS COLMSG 


Running COL 
To run COL, type a command line of the form: 
>COL logfile/sw=MPBfile/sw 


The default logfile specification is SY:[cur uic]JTRACE.LOG. 
The default MPBfile specification is SY:f[cur uic]TRACE.MPB. 


Stopping COL 
There are two ways to terminate COL: 
fe) RUN TRM 
0) Specify AUTOSTOP or REPEAT mode in SMPGEN. 


RUN TRM will terminate COL regardiess of the mode in which COL 
is running: MANUAL, AUTOSTOP or REPEAT. 


12/81 GUIDE TO USING SPM-11M-PLUS 3-14 


COL will 


also terminate if any of the following abnormal 


conditions are detected: 
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0 


Powerfail recovery 


COL will issue a SPRA$ directive. Upon powerfail 
recovery, COL will simply exit. 


Write errors 

If COL detects write errors, it will print a message 
and exit. Write errors will generally corrupt the 
logfile with invalid data. 


Automatic 11 1/2 hour termination. 
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COL Switches 


Switch defaults -- 


Output: SY:TRACE.LOG/DENS :800/EX :100./IF :100./WI:10. 
Input: SY :TRACE.MPB/BF :2 :8/DL :0/DV :LBO/PR:GEN 


Output Switches Description 


/ AP - Append records to end of magtape. COL will 
space over all existing files on the magtape 
and append the records for this run starting 
at the current end-of-volume point. 


/DENS :density Set tape density to 800 or 1600 bpi..- 
Densities cannot be mixed on a single tape 


volume. 

/EX:n Specifies disk file extent size in 256W 
blocks. 

/IF cn Specifies disk file initial size in 256W 
blocks. 

/WI in Specifies number of retrieval pointers. in 


window block. 


Input Switches 


/BF smn Number of buffers = m ; size of buffer = n 
256W blocks. This overrides the buffering 
description in the MPB. 


/DL in Number of MINUTES COL delays before it 
starts data collection. 


/DV:ddnn Device selected for system metrics. 


/PR :parnam Partition selected for system metrics. 


/Tl:nn Collect data only for tasks with TI of TTnn. 
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Example 1 
>COL DB2:[3,300]CPUTEST/IF :1000/EX :200=DB1 :[5,200]PARM1/DY :DB2: 


logfile is DB2:[3,300]CPUTEST.LOG with initial size 1000 and 
extent size 200. 


MPB file is DB1:[5,200]PARM1.MPB with system metrics specified 
for DB2. 


Example 2 
>COL MM1:/DENS :1600=DB1:[5,200 |SAMPLE.MPB 


logfile 1s on MMI<-in 1600 BPI; MPB filets 
DB1:£5,200]SAMPLE.MPB. 


Example 3 
>COL = 


logfile is SY¥:[current uic]TRACE.LOG; MPB file is SY:[current 
uic]TRACE.MPB. . 


NOTE: You cannot run COL with a null command line, i.e, COL 
<CR>. The COL task expects to see explicit filespecs or a 
bare "=" indicating defaults on both input and output. More- 
over, you cannot invoke COL with a command of the form: 


>RUN COL 


since no filespecs can be specified with this form. One final 
thought in this regard: only one copy of COL can be active in 
the system at a time. If multiple invocations of COL are 
attempted at different terminals, all but the first will be 
rejected with an error message “MONITORING ACTIVITY IN 
PROGRESS". 


Once COL is activated, it will run in the mode specified in the 
MPB but always for a maximum of 11 1/2 hours. This time limit 
is imposed because the KW11-P clock time will overflow in a 
little over 11 1/2 hours. 
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COL Messages 


COL outputs two types of messages: error messages and status 
messages. 


Full ASCII error message text will be printed only if the 
COLMSG task is installed. If the COLMSG task is not installed, 
COL will print a message of the form "COL ERROR XXXXXX", where 
XXXXXX is the error number. The error messages are listed by 
error number in the following list. Error messages are issued 
if an error condition occurs while COL is starting up and 
initializing the performance monitor. Error messages are 
output to the terminal of issue (TI:) for COL. 


Status messages are issued after COL has run its initialization 
phase. There are status messages for both normal and error 
conditions. Status messages are issued to the console terminal 
(C0 s)\s The COLMSG task does not have to be installed to get 
the status messages; as they are printed directly by the COL 
task. 

COL Error Messages 

000000 COLMSG -- XXXXXX (DSW) GET COMMAND LINE ERROR 


Explanation: A "Get MCR Command Line" directive failure 
occurred, 


User Action: Reenter COL command line using correct 
form. 
NOTE: Illegal command forms are: 

1, >COL. <CR> 


2. >RUN $COL <CR> 


Legal command line forms are: 
1. >COL filespec/sw = filespec/sw 
2. >COL filespec/sw 


/Sw 
3. >COL =filespec/sw 
4. >COL = 


12/81 GUIDE TO USING SPM-11M-PLUS 3-18 


000001 


000002 


000003 


000004 


000005 


000006 


000007 


LZ7 et 


COLMSG -- COMMAND SYNTAX ERROR 

Explanation: Entered incorrect syntax for command line. 
User Action: Reenter command line with correct syntax. 
COLMSG -- MPB FILENAME SYNTAX ERROR 

Explanation: Entered incorrect syntax for MPB filename. 
User Action: Reenter MPB filename using correct syntax. 
COLMSG) «= XXXRXE CPCS) MPS ETE ACCESS FAILURE 
Explanation: COL failed to open MPB file or received a 
read error when attempting to read the MPB file. The 
code XXXXXX (FCS) indicates the FCS error code returned 
to. GOL. 

User Action: Check that specified MPB file exists, the 
volume is mounted (if disk), or that the file protection 
does not prevent COL from reading the MPB. 

COLMSG -- XXXXXX (DSW) ASSIGN LUN FAILURE 


Explanation: COL failed to assign a LUN to the logfile 
device. 


User Action: Check that the device specified for 
logfile is in the system configuration. 


COLMSG -- ILLEGAL LOGFILE DEVICE TYPE 

Explanation: The device specified for the logfile is 
not of the correct type. Valid logfile device types 
are: Directory structured (disk, DECTAPE), or Sequential 
(magtape). 


User Action: Specify a device which is either directory 
structured or sequential. 


COLMSG -- LOG FILENAME SYNTAX ERROR 
Explanation: Entered incorrect syntax for logfile. 


User Action: Reenter logfile specification using 
correct syntax. 


COLMSG -- XXXXXX (FCS) LOGFILE ACCESS FAILURE 


Explanation: COL failed to open the logfile. The code 
XXXXXX (FCS) is the FCS error returned to COL. 
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000010 


000011 


000012 


000013 
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User Action: Check that the logfile volume is mounted 
native and the necessary directory exists (if disk), or 
the volume is mounted foreign and online (if magtape). 


COLMSG -- ILLEGAL BUFFER SPECIFIED 


Explanation: The parameters specified by the /BF:n:m 
switch were not valid. Either the number of buffers (n) 
was out of range (<2 or >8) or the buffer size was out 
of range (>16). 


User Action: Respecify a valid buffer count or size via 
the /BF switch. 


COLMSG -- XXXXXX (DSW) BUFFER PARTITION NOT IN SYSTEM 


Explanation: The partition specified in the MPB is not 
in the system. 


User Action: If the buffer partition is a static 
common, check that the static common partition exists 
and that the common is installed. 


COLMSG -- BUFFERS WILL NOT FIT INTO PARTITION 


Explanation: The number of buffer blocks specified in 
the MPB (NUMBER OF BUFFERS * BUFFER SIZE IN 512 B 
BLOCKS) is greater than the number of 512 B blocks in 
the physical buffer partition. 


User Action: Do a SMPGEN and specify the NUMBER OF 
BUFFERS and BUFFER SIZE IN 512 B BLOCKS such that the 
product of the two is less than the number of 512 B 
blocks in the physical buffer partition. 


COLMSG -- XXXXXX (DSW) CANNOT CREATE BUFFER PARTITION OR 
ADDRESS WINDOW 


Explanation: COL received a DSW error when attempting 
to create the dynamic buffer partition specified in the 
MPB, or when attempting to create an address window to 
map the dynamic partition. The error XXXXXX (DSW) is 
the DSW error from the Create Region directive or from 
the Create Address Window directive. 


User Action: Check that enough space exists in the 


partition to contain a dynamic region with the size 
specified in the MPB. 
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000016 


000017 


000020 
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COLMSG -- MONITORING ACTIVITY IN PROGRESS 

Explanation: A multiple invocation of the COL task was 
attempted. Only one copy of COL can be active at a 
time. 

User Action: Do not attempt to run more than one copy 


of COL at a time. 
COLMSG -- INVALID MPB FILE 


Explanation: The MPB filespec specified in the COL 
command line is not the name of a valid MPB file. 


User Action: Reenter a filespec for a valid MPB file. 
COLMSG -- INFORMATION RECORD ALLOCATION FAILURE 


Explanation: Insufficient space exists in the buffer 
partition to contain all the Information Records. 


User Action: Do a SMPGEN and specify enough blocks 
(NUMBER OF BUFFERS * BUFFER SIZE IN 512 B BLOCKS) to 
contain all the Information Records. The space required 
is roughly that needed to contain the largest of the 
following three system lists: 1)TCBs, 2)PCBS; 3) 
DCB-UCBs. 


COLMSG -- KW11-P VECTOR OR CSR UNAVAILABLE 


Explanation: Either the KW11-P vector is in use, or the 
KW11-P CSR is non-existent on the UNIBUS. 


User Action: Check that the correct KW11-P vector and 
CSR were specified in the procedure @PMONBLD.CMD, that 
the vector is not used by another RSX-11M-PLUS driver or 
task, and that the CSR is addressable on the UNIBUS. 


COLMSG -- CANNOT USE SYSTEM'S KW11-P AS SPM-11M-PLUS 
CLOCK 


Explanation: The RSX-1LIM-PLUS system clock is a KW11-P 
and an attempt was made to use it as the SPM-11M-PLUS 
(performance monitor) clock. 


User Action: Check that a separate KW11-P was installed 
for use by the SPM-1L1IM-PLUS software, and that the 
vector and CSR specified in the procedure @PMONBLD.CMD 
was for this clock. 
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COLMSG -- POOL NODE ALLOCATION FAILURE 


Explanation: COL could not allocate a RSX-11M-PLUS pool 
node. 


User Action: Re-run COL when sufficient pool is 
available. 


COLMSG -- BUFFER OVERFLOW 


Explanation: COL failed to allocate space for a hook 
record because all buffers were full. 


User Action: Re-run COL, using a larger buffer size 
specified either via SMPGEN. CMD or the /BF switch. 


COLMSG -- PARTITION SPECIFIED NOT IN SYSTEM 


Explanation: The partition specified via the /PR switch 
is not configured in the system. 


User Action: Respecify a partition configured in the 
system. 


COLMSG -- ILLEGAL DELAY VALUE SPECIFIED 


Explanation: An illegal delay value has been specified 
via the /DL switch. 


User Action: Re-specify a delay value in the correct 
range (0 to 28800). 


COL Status Messages 


COL -- 


COL -- 


12731 


PERFORMANCE MONITOR INITIALIZED 


Explanation: COL has successfully initialized and is 
now ready to collect data. 


User Action: None 

PERFORMANCE MONITOR EXITING 

Explanation: COL has stopped data collection and has 
cleaned up its databases. This status message is issued 


by COL immediately prior to exiting. 


User Action: None 
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COL -- CANNOT MAP OUTPUT BUFFER 


Explanation: COL received an error when attempting to 
map to the output buffer using the Map directive. 


User Action: Check that the dynamic region used as the 
output buffer was successfully created. 


COL -- LOGFILE WRITE ERROR 


Explanation: COL received an FCS or QIO error when 
attempting to write to the logfile. 


User Action: Check the integrity of the logfile. If 
repeated errors occur to the same logfile, rerun COL to 
create a new disk file or mount a fresh tape. Ensure 
the logfile volume is mounted via the MOU command. 


COL <= LOGFILE CLOSE ‘ERROR 
Explanation: COL received an error when attempting to 
close the logfile. COL will exit shortly after printing 
this message with the logfile improperly closed. 


User Action: Because the logfile was improperly closed, 
it may be difficult to read the logfile and produce a 
performance report. 


COL -- BUFFER OVERFLOW 


Explanation: Hook records were written to the “hook 
buffer faster than COL could write them to the logfile. 


User Action: In general, the data collected during a 
measurement interval which overflowed is not usable by 


the MDR task to produce a performance report. An 
attempt should be made to rerun the measurement to 
obtain data without overflow. Prior to attempting 


another measurement run, a SMPGEN should be run with 
larger buffers specified than for the measurement run 
which overflowed. 


3.2.3 Using TRM 

The TRM task is used to manually signal the COL task to stop 
data collection, cleanup and exit. TRM will cause COL to exit, 
regardless of the mode in which COL was running: manual, 


autostop or repeat. 


TRM is run by the command >RUN TRM. 
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ge244 Using MDR 


MDR is used to read the logfile and produce a performance 
report. MDR is used in conjunction with DRS (sorting) task to 
produce the performance report. The general procedure is as 
follows: 


0) >INS DRS 
>RUN MDR 
MDR>LISTFILE/sw=LOGFILE/sw 


MDR will read the command line and execute pass 1. MDR 
will then attempt to spawn the task DRS. If MDR 
detects an error in the spawn, or MDR has been built 
to prevent automatic spawn, the DRS pass must be 
executed manually. In this case, MDR will print the 
following message and suspend: 


MDR -- YOU MUST NOW SORT THE INTERMEDIATE FILE BY 
USING DRS.TSK 


MDR -- 
>DRS RESOURCE. SRT=RESOURCE.TMP/FO :V :156/KE :1.12/PR :T 


MDR -- AFTER THE SORT HAS COMPLETED, RESUME THIS TASK 
(...MDR) 


NOTE: Rather than type the command line to DRS as shown 
above, you can simply invoke the command file @DRS. 


0 >@DRS sorts the intermediate file. 
0) >RES 

MDR executes pass 2 and prints the performance report. 
fc) MDR> Z 


Certain MDR command switches restrict the input data which will 
be processed. If a logfile contains too much activity for MDR 
to reduce the data without running out of Space, these switches 
(/AF, /BF, /-MD, /NT, /NU, /TS, /UC) may be used to reduce a 
logfile by successive runs of MDR, analyzing only parts of the 
workload in each run, 


When using the switches /NT, /NU, /TS, or /UC, MDR will prompt 
for the task or device names after the command line is 
processed. The tasknames are specified as 1 to 6 RAD5O 
characters per entry. Only generic tasknames are used for /NT 
or /TS. The TI device names are entered as "DDnn:", with one 
entry per line. 


12/81 GUIDE TO USING SPM-11M-PLUS 3-24 


Switch defaults - 


MDR Switches 


output: SY :REDUCE.RPT/SP 


input: SY :TRACE.LOG/DM :2/LI :2/RW/SI :613/MD/SK :0/DE :800/-IC/-SC 


Output Switches 


{SP /-SP 


Input Switches 


/ AF :PChigh:PClow 


/BF :PChigh :PClow 


/DE :nnnn 


/DM:nn 


P2/31 


Description 


SPool output file 


Only 
time 


Only 
time 


process records from AFter specified 


process records from BeFore specified 


Select input magtape DEnsity, 800 or 1600 
(ignored unless /RW is also used) 


DuMp 


specified record types, nn is total of 


desired types: 


Oi < 
02 - 
04 - 
10° 
20h 
40 - 
100. ce 
200 - 


buffer headers 

unknown record types 

system configuration info records 

task event hook records 

system metric records 

user information hook records (H$USER) 
load overlay hook records (H$0VLY) 
call directive processor hook records 
(H$CDRP) 


Replace the % resource column of the report 


with 


a count of incomplete intervals. 


Detail level of task workload metrics: 


OO" 
Ol <2 
O2b. 
G3.:2 
04 - 


05 - 


no report produced 

system-wide summary only 

system and task summaries 

system, task, and Tl: summaries 

all summaries and each complete 

task run 

all summaries and all task invocations 


(continued on next page) 
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Input Switches 


/MD /-MD 
FNT > 
/NU * 


/SC /-SC 


/SI inn 


/SK :nnn 

/RW /-RW 
TS. * 

{VG * 


MDR Switches (continued) 


Description 


Report on tasks with missing data 
Do Not process hooks for listed Tasks 


Do Not process hooks for listed devices as 
TI: 


Produce System Configuration section of 
report 


Selects the contents of Sampling Interval 
report by setting nn to the total for the’ 
desired items: 


000 - no report produced 

001 - data collection start/stop times 

002 - % CPU usage 

004 - %4 memory partition usage 

010 - % device time busy 

020 - %4 device space used 

040 - % POOL used 

100 - % CKPT space used 

200 - clock time of metrics 

400 - trailing blank line after the metrics 


SKip nnn files when opening tape input file 
ReWind tape input file before opening 
Process hook records only for listed TaSks 


Process hook listed 


devices as TI: 


records only for 


* - the switches /NT and /TS are mutually exclusive. 
- the switches /NU and /UC are mutually exclusive. 
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MDR Messages 


The MDR messages are issued to the TI device under which MDR 


runs. 


MDR -- 
MDR -- 


MDR -- 


MDR -- 
MDR -- 


MDR -- 


MDR -- 
MDR -- 


MDR -- 


MDR -- 


MDR -- 
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This section discusses the messages which MDR can issue. 


PLEASE ENTER TASKNAMES ONE AT A TIME FOLLOWING EACH 

WITH A <CR>. TYPE JUST A <CR> AFTER THE LAST ONE IS 
ENTERED 

TSKNAM> 


Explanation: This is the prompt for the generic task- 
names for filtering by the /NT or /TS switch. The last 
line of this message is repeated for each line of input. 


User Action: Enter generic task name(s). 


PLEASE ENTER TI DEVICES (DDNN:) ONE AT A TIME FOLLOWING 
EACH 

WITH A <CR>. TYPE JUST A <CR> AFTER. THE LAST ONE IS 
ENTERED 
TI DEVICE> 


Explanation: This is the prompt for device names to be 
used by the /UC or /NU filter. The last line of this 
message is repeated for each line of input. 


User Action: Enter full device name(s) as "DDnn:". 


YOU MUST NOW SORT THE INTERMEDIATE FILE BY USING DRS.TSK 
(E.G.) MCR>DRS 

RESOURCE. SRT=RESOURCE. TMP/FO :V :156/KE :1.12/PR :T 

AFTER THE SORT HAS COMPLETED, RESUME THIS TASK (TSKNAM) 


Explanation: This message indicates that the first pass 
of MDR has completed. Manual intervention is now 
required to run the DRS task with the given command. 
The task name under which MDR is running is given in 
parenthesis in the last line of the message. 


User Action: Run the DRS task (@DRS.CMD), and when it 
has completed, resume the MDR task. 


DSW :###4## F.ERR :#####4# I0SB :#####4 ##EHHE PC #PET HF 
SP :###### 
STK :####4# #HEHEE 


Explanation: This is a status message which gives 


detail of the internal state of MDR at the time when an 
error is detected. This message is always followed by 
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MDR -- 


MDR -- 


MDR -- 


MDR -- 


MDR -- 
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one of the messages discussed below, which describes the 
actual error condition. 


User Action: See action specified for the message 
issued immediately following this status message. 

AN INCOMPLETE RESOURCE UTILIZATION REPORT WILL BE 
PRODUCED 

Explanation: An error occurred which prevented the 
completion of pass II of MDR. Although a report will be 
produced, not all task-workload data has been summa- 
rized. A previous error message is issued giving the 
cause of this condition, 


User Action: As specified for previous message. 


ATTEMPT TO PRINT NULL TWB 


Explanation: An internal inconsistency occurred in the 
pass II processing of MDR. 


User Action: * * * SPR ! 
ATTEMPTING TO DEALLOCATE TWB NOT IN TSKHD 


Explanation: An internal inconsistency occurred in the 
pass I processing of MDR. 


User Action: * * * SPR ! 


CHECKPOINT USAGE > 100% 

Explanation: A Checkpoint metric indicates more than 
100% usage of the checkpoint space. The metric is not 
reported. 


User Action: Ensure logfile is not corrupted. 


CLOCK STOPPED OR HOOK RECORD OUT OF TIME SEQUENCE. 
Explanation: The records in the logfile do not follow a 
strict time sequence. This condition invalidates the 
data in the logfile. 


User Action: Ensure that the KW11-P clock is 
functioning. Re-collect the data. 
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MDR -- COMMAND READ ERROR 


MDR -- 


MDR -- 


Explanation: An I/0 error occurred while attempting to 
read the MDR command line. 


User Action: Reenter the MDR command. 


COMMAND SYNTAX ERROR 


Explanation: The command as entered has improper 
syntax. 


User Action: Reenter the corrected MDR command. 


COMPLETION ERROR IN INPUT READ 


Explanation: An I/0 error occurred while reading the 
logfile. This condition will be treated as end-of-file 
and MDR will attempt to continue. This may be 
symptomatic of a corrupted logfile. 


User Action: Check IOSB for error cause. Rerun MDR 
using another logfile if necessary. 


MDR -- CONFLICTING SWITCHES /TS+/NT OR /UC+/NU 


MDR -- 


MDR -- 
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Explanation: The switches /TS and /NT were both speci- 
fied, or the switches /UC and /NU were both specified. 
Only one of each pair of switches may e specified. 

User Action: Reenter the command line without both of 
the conflicting switches. 

DEVICE USAGE > 100% 

Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of device utili- 
zation. No graphic output will be produced for the 
suspect record. 


User Action: * * * SPR ! 
DEVICE'S ACP NOT FOUND 


Explanation: The system information records indicated 
that a device was mounted, yet no TCB for the ACP task 


GUIDE TO USING SPM-11M-PLUS 3-29 


MDR -- 


MDR -- 


MDR -- 


MDR -- 
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was found. The device may have been dismounted concur- 
rently with COL's scan of the system configuration. A 
generic ACP name will be used for the device's ACP 
functions. 


User Action: None. 


DYNAMIC SPACE ALLOCATION FAILURE 


Explanation: MDR was unable to sufficiently extend 
itself to provide space for initialization of pass I. 
This indicates a severe shortage of necessary dynamic 
space. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. 


ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 

Explanation: An I/0 error occurred when attempting to 
open the logfile on magtape. The drive may have been 
mounted to MTAACP which is incorrect since MDR does QI0Os 
directly to the tape device driver. Ensure the magtape 
is mounted foreign. 


User Action: Correct the condition and rerun MDR. 


ERROR CLOSING INPUT FILE 


Explanation: An I/0 error occurred when closing the 
input logfile. 


User Action: None. 


ERROR CLOSING REPORT FILE 


Explanation: An 1/0 error occurred when closing the 
report file. This file will not be properly closed or 
spooled, or MDR attempted to spool the output file but 
the task PRT... was not installed. 


User Action: Correct the condition and manually close 
the file, or rerun MDR,. 
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MDR -- 


MDR -- 
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ERROR CLOSING RESOURCE.TMP FILE 

Explanation: An I/0 error occurred at the end of pass I 
when closing the RESOURCE.TMP file. The DRS task will 
not be able to read this file until it is properly 
closed. 

User Action: Correct the condition and manually close 
the file, or rerun MDR. 

ERROR DELETING RESOURCE.TMP FILE 

Explanation: An I/0 error occurred when MDR deleted 
its temporary file. The file is not properly closed, or 
deleted. 


User Action: Manually unlock and delete this file. 


ERROR IN GTSK$S 

Explanation: The directive failed preventing MDR from 
obtaining its taskname. The message requesting the sort 
to be run will not include MDR's taskname. 


User Action: None. 


ERROR IN INPUT READ QIO 


Explanation: An I/O error occurred while reading the 
logfile. This condition will be treated as end-of-file 
and MDR will attempt to continue. This may be 
Symptomatic of a corrupted logfile. 


User Action: Check DSW for error cause. Rerun MDR 
using another logfile if necessary. 

ERROR OPENING RESOURCE.SRT FILE 

Explanation: An error was reported by FCS when MDR 
attempted to open the RESOURCE.SRT file for pass II. 


Pass II will not be able to run. 


User Action: Correct the condition indicated by F.ERR 
and rerun MDR. 
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ERROR OPENING RESOURCE.TMP FILE 

Explanation: An error was reported by FCS when MDR 
attempted to open the RESOURCE.TMP file for write in 
pass I. Pass I will not be able to run. 

User Action: Correct the condition indicated by F.ERR 
and rerun MDR. 

ERROR OUTPUTTING PRINT LINE 

Explanation: An error was reported by FCS when MDR 
attempted to output a record to the report file. MDR 
will attempt to continue to produce the report. If this 
error is not caused by a transient condition the message 
will be repeated, and MDR will have to be aborted. 


User Action: Correct the condition and rerun MDR. 


ERROR READING MPB 


Explanation: An I/0 error occurred when attempting to 
read the first block of the logfile. 


User Action: Correct the condition and rerun MDR. 


ERROR READING RESOURCE.SRT FILE 

Explanation: An I/0 error occurred in pass II when 
attempting to read from the RESOURCE.SRT file. This 
will be treated as an end-of-file condition. 


User Action: Correct the condition and rerun MDR. 


ERROR REOPENING RESOURCE.TMP FILE 

Explanation: An I/0 error occurred when attempting to 
re-open the RESOURCE.TMP file so it could be deleted. 
The RESOURCE.TMP file will not be deleted. 


User Action: Delete the file manually. 


ERROR SKIPPING OVER MPB BUFFER 
Explanation: An I/O error occurred when repositioning 


the tape logfile so the MPB could be reread once the 
buffer size is known. 
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User Action: Correct the condition and rerun MDR. 


ERROR WRITING RESOURCE.TMP FILE 


Explanation: An I/0 error was reported by FCS for a 
write operation during pass I. 


User Action: Correct the condition and rerun MDR. 


EXPECTED RIB NOT FOUND 


Explanation: An inconsistency occurred in MDR's 
internal dynamic data structures. 


User Action: See Chapter 7, Section 7.3. 


EXPECTED RWB PREDECESSOR NOT FOUND IN OVERLAP 


Explanation: An inconsistency occurred in MDR's 
internal dynamic data structures. 


User Action: * * * SPR ! 


EXPECTED RWB PREDECESSOR NOT FOUND IN MERGE 


Explanation: An inconsistency occurred in MDR‘'s 
internal dynamic data structures. 


User Action: * * * SPR ! 


IDLE TIME > 100% 

Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of CPU idle time. No 
graphic output will be produced for the suspect record. 


User Action: See Chapter 7, Section 7.5. 


S 


MPROPER FORMAT OR NO SUCH DEVICE IN SYSTEM. PLEASE 
ET EP Es 


I 
R 


Explanation: An improper response was entered to the 
prompt for TI filter devices. 


User Action: Enter a corrected response. 
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MDR - 


MDR - 


MDR - 


MDR - 


MDR - 
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INPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: An improper command line was used with 
MDR. 


User Action: Reenter the command. 


INVALID DENSITY SELECTED, 800 OR 1600 ONLY 


Explanation: A magtape density other than 800 or 1600 
was specified. 


User Action: Reenter the command with the correct 
density. | 

INVALID DEVICE SPACE METRIC RECORDED 

Explanation: A system metric record indicates more than 
100% of device space used. The device space metric will 
not be reported. This metric is only available ffor 
devices mounted to F11ACP. 


User Action: Ensure logfile not corrupted. 


INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to reduce a logfile 
which is not on either a disk or tape volume. MDR can 
only use disk or tape for the input file. 

User Action: Do not use MDR to read logfiles not 
residing on disk or tape. 


INVALID INPUT FILESPEC 


Explanation: A syntax error occurred in the input 
filespec part of the MDR command. 


User Action: Correct and reenter the command. 


INVALID LISTING LEVEL 


Explanation: An invalid listing level was specified in 
the /LI switch. Acceptable values range from 0 to 5. 


User Action: Correct and reenter the command. 


GUIDE TO USING SPM-11M-PLUS 3-34 


MDR -- 


MDR -- 


MDR -- 


MDR -- 


MDR -- 


12/81 


INVALID MPB FOUND BY ALC 

Explanation: The logfile was found to contain improper 
data. This may be a result of using MDR to read a 
logfile produced by an incompatable COL version. This 
may also be the result of using MDR to read a file which 
was not produced by COL, or was corrupted. 


User Action: Rerun MDR using a valid logfile. 


INVALID MPB FOUND BY INF 

Explanation: The MPB did not pass validity testing when 
it was reread once the logfile buffer size was known. 
The logfile may have been corrupted while MDR_ was 
processing it. 


User Action: * * * SPR ! 


INVALID POOL METRIC RECORDED 


Explanation: A Pool metric indicates more than 100% DSR 
usage. The metric is not reported. 


User Action: Ensure logfile is not corrupted. Do not 
change DSR size while COL is running. 

INVALID RAD50 CHARACTER IN YOUR INPUT. PLEASE RETYPE. 
Explanation: The response to the taskname prompt for 
filtered names was not a valid RSX-11M-PLUS taskname. 


All letters should be in uppercase. 


User Action: Correct and retype the response. 


INVALID TIME VALUES; /AF MUST BE EARLIER THAN /BF 
Explanation: An attempt to use time filter values which 
overlapped causes this message. This condition will not 
allow any records to pass the filter for processing. 


User Action: Correct and reenter the MDR command. 
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MEMORY USAGE > 100% 

Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of partition utili- 
zation. No graphic output will be produced for the 
Suspect record. 


User Action: * * * SPR | 


MISSING INFO FOR DEVICE METRIC 

Explanation: The Info record describing the system 
metric device was not found. Device system metrics will 
not be reported. 

User Action: Do not load or unload device drivers while 
COL is active. Ensure logfile is not corrupted. 


MISSING I$SYS FOR POOL METRICS 


Explanation: The DSR size was not found in the logfile. 
The Pool system metric is suppressed. 


User Action: Ensure logfile is not corrupted. 


MISSING “=" AND INPUT FILESPEC 

Explanation: The input command contains no "=" and no 
input filespec. Both input and output filespecs must be 
supplied or defaulted. 

User Action: Enter a corrected MDR command including 
the "=", 

MORE THAN ONE INPUT FILESPEC NOT ALLOWED 


Explanation: The MDR command contains more than one 
input filespec. 


User Action: Enter a corrected MDR command with only 
one input filespec. 
MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 


Explanation: The MDR command contains more than one 
output filespec. 
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User Action: Enter a corrected MDR command with only 
one output filespec. 

MPB FOUND AT LOCATION OTHER THAN FIRST RECORD OF FILE 
Explanation: An MPB was read in the wrong position in 
the logfile. This is indicative of a corrupted logfile. 
MDR will bypass this MPB and attempt to continue to 
process the corrupted logfile. Reports produced from 
this logfile are suspect. 


User Action: Use a different logfile for analysis. 


MPB NOT FOUND - NOT TRACE FILE 

Explanation: The MDR input file did not begin with a 
MPB. Either the file was corrupted or it is not a 
logfile. 


User Action: Use a different logfile for analysis. 


NO FOLLOWING PRIMARY RWB FOUND 


Explanation: An internal inconsistency was detected in 
pass I. 


User Action: * * * SPR ! 


NO FPP OR BUILT /-FP 


Explanation: MDR is unable to initialize for FPP ASTs. 
Either MDR was taskbuilt with the /-FP switch, or the 
processor where MDR is running has no FPP. This message 
cannot occur if the EIS version of MDR is used. 


User Action: Rebuild MDR using the distributed .CMD 
file. Only run the FPP version of MDR on processors 


with an FP-1l. 


OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the output 
filespec or an invalid output switch was specified. 


User Action: Correct and reenter the MDR command. 
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OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The logfile indicates buffer overflow 
occurred before the MPB was written. Either the logfile 
was corrupted, or the file was not produced by COL. 


User Action: Use another file for MDR input. 


OVERFLOW IN FIRST PASS SUMMARIZATION 


Explanation: A floating overflow occurred in pass I. 
Incorrect data will be reported for the particular task 
and summaries which this data represents. 


User Action: Use the resulting report with caution. 


Use filtering to limit the amount of data processed to 
prevent this condition. 


OVERFLOW IN SECOND PASS SUMMARIZATION 

Explanation: A floating overflow occurred in pass II. 
Incorrect data will be reported for the particular task 
and summaries which this data represents. 

User Action: Use the resulting report with caution. 
Use filtering to limit the amount of data processed to 
prevent this condition. 

PARTITION RIB NOT FOUND FOR S$MEM 

Explanation: A system metric record was read for a 
partition which was not described by the system con- 
figuration information records. The graphic output of 
memory utilization will be suppressed. 


User Action: None. 


PRINT LINE TOO LONG 
Explanation: MDR generated a report file record longer 
than 132 bytes. The line is truncated by the logic 
which writes to the file. 


User Action: * * * SPR I 


GUIDE TO USING SPM-11M-PLUS 3-38 


MDR -~ 


MDR - 


MDR - 


MDR - 


MDR - 


MDR -- 


12/81 


RIB LIST LINKAGE ERROR 


Explanation: An inconsistency was detected in MDR'‘'s 
internal representation of the system configuration. 


User Action: * * * SPR ! 


RWB WITHOUT TWB FOUND IN RESOURCE.TMP 

Explanation: A record in the RESOURCE.SRT file was 
encountered in an illogical position. The record is 
disgarded. 


User Action: * * * SPR ! 


SUMMARIZING FROM NULL TWB 


Explanation: An inconsistency was detected in the pass 
II data structures. 


User Action: * * * SPR ! 


SUMMARIZING INTO NULL TWB 


Explanation: An inconsistency was detected in the pass 
II data structures, © 


User Action: * * * SPR ! 


SVTK FAILURE 


Explanation: The RSX executive rejected MDR's attempt 
to specify an SST vector. 


User Action: Correct the condition indicated by the DSW 
and rerun MDR, 

SYSTEM + IDLE TIME > 100% 

Explanation: A system metric record was read which 
indicates the total of kernel and idle time is greater 
than the elapsed time. The graphic output for the 
record is suppressed. 


User Action: See Chapter 7, Section 7.5. 
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SYSTEM TIME > 100% 


Explanation: A system metric record was read which 
indicates more kernel time than elapsed time. The 
graphic output for the record is suppressed. 


User Action: See Chapter 7, Section 7.5. 


TI: READ ERROR 


Explanation: An I/0 error occurred when reading filter 
values from the uSer. The read with prompt which is 
used to obtain these inputs is not valid from a VT: 
(e.g. BATCH) 


User Action: Rerun MDR. 


TRAP ### 


Explanation: A floating point or conversion error 
occurred. The octal number in this message indicates 
the precise error cause. 


User Action: * * * SPR ! 


TRUNCATED INPUT FILE RECORD 


Explanation: The end of a buffer was reached before all 
the records in that buffer were processed. This 
indicates a corrupted logfile. 


User Action: Use a different logfile for analysis. 


TWB/RWB/RIB DYNAMIC SPACE ALLOCATION FAILURE 


Explanation: MDR was unable to get needed virtual space 
for a dynamic structure in pass Il. However sufficent 
dynamic storage was obtained to begin pass I. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. Use of filtering of MDR input will also 
lower this space requirement. Use overlaid MDR. 
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UNABLE TO ALLOCATE RESOURCE.SRT BUFFER 


Explanation: MDR was unable to get needed virtual space 
for a dynamic structure in pass II. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of filtering of MDR input will lower this space 
requirement. Use overlaid MDR. 


UNABLE TO ALLOCATE RIB 

Explanation: MDR was unable to sufficiently extend 
itself to provide space for initialization of pass I. 
This indicates a severe shortage of necessary dynamic 
space. 

User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. 

UNABLE TO OPEN INPUT FILE 


Explanation: An I/0 error occurred when MDR attempted 
to open the logfile. 


User Action: Correct the condition and rerun MDR. 


UNABLE TO OPEN OUTPUT FILE 


Explanation: An I/0 error occurred when MDR attempted 
to open the report file. 


User Action: Correct the condition indicated by F.ERR 
and rerun MDR. 
UNKNOWN INFO TYPE RECORD FOUND 


Explanation: A corrupted logfile, or a file not 
produced by COL is being used as MDR input. 


User Action: Use a different file for MDR input. 
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UNKNOWN RECORD TYPE 


Explanation: A corrupted logfile, or a file not 
produced by COL is being used as MDR input. 


User Action: Use a different file for MDR input. 


VT UNIT NUMBER EXCEEDS PREDEFINED MAXVT 

Explanation: An I$CVT, I$ELV, or I$UCB record was 
encountered for a virtual terminal with a unit number 
which exceeds the predefined maximum MAXVT. | 

User Action: Rebuild MDR with a larger value defined 
for this maximum. See sections 7.4 and 7.5. 

VTO: DCB OR UCB NOT PROCESSED BY INF 

Explanation: An I$CVT or I$ELV record was encountered 
without processing the I$DCB and I$UCB records for VTO: 
(prototype VT database). This indicates the database 
for the VT: devices was loaded after invoking the COL 
task. 

User Action: See section 7.3. 

WILDCARD NOT ALLOWED IN FILESPEC 

Explanation: The MDR command contains a wildcard. 


User Action: Reenter the command without any wildcards. 


WRONG FOLLOWING PRIMARY RWB FOUND 


Explanation: An inconsistency was detected in MDR's 
pass I dynamic data. 


User Action: * * * SPR ! 
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3.2.5 Using CLF 


CLF is used to copy logfiles produced by COL. The three modes 
of CLF operation are: 


) Buffer Transfer Mode, 


which copies a logfile from either disk or tape, to 
disk or tape, maintaining the logfile format which MDR 
uses for input. 


0) FCS Record Transfer Mode, 


which copies a logfile from either disk or tape, 
producing: an output file with variable length FCS 
records. 


0 Read-only -Mode, 


which reads the logfile, computes overflow and buffer 
counts, but does not create a new file. 


The general procedure for using CLF is: 


>RUN CLF 
CLF> [OUTFILE/sw =] LOGFILE/sw 


Note that the output filespec and "=" are optional. If these 
are not specified, CLF will operate in read-only mode, 
producing no output file. 


When FCS mode is specified (by the /FCS switch), the records 
have the format specified in appendices A through D. The first 
word of each record is the record ID which uniquely identifies 
the record type. If overflows occur within the data stream, a 
special “overflow record" is placed in the output file at the 
point where records were lost due to overflow. The format of 
this (length = 4. bytes) record is: 


600 0 600(8) = overflow record ID 
# # # Z count of records lost by overflow at 
this point 


When the /FCS switch is used, the default output filespec is 
changed to TRACE.FCS. 


After CLF has completed reading the input file, the run 
statistics will be reported to CLF's TI:. 
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CLF Switches 
Switch defaults -- 
output: SY:TRACE.LOG/-AP/DE :800/-FCS 
input: SY :TRACE.LOG/DE :800/RW/SK :0 


Output Switches Description 


/ AP /-AP APpend file to the end of magtape. CLF 
_ will space over all existing files on the 
magtape and write the new file starting at 
the current end-of-volume point. 


/DE :nnnn Selects output magtape DEnsity, 800 or 1600 


/FCSE:nn] /-FCS Selects FCS sequential records in the 
output file, and changes the default output 
filespec to TRACE.FCS. If "inn" is not 
specified, all record types will be copied. 
If "inn" is specified, only selected record 
types will be written. "nn" is the total 
for desired record types: 


01 - overflow records 

04 - system configuration records 

10 - task event hook records 

20 - system metric records 

40 - user inserted records 

100 - load disk overlay records 
200 - call directive processor records 


Input Switches 


/DE :annn Selects input magtape DEnsity, 800 or 1600 
(ignored unless /RW is also used) 


/RW /-RW ReWind tape input file before opening 


nnn SKip nnn files when opening tape input file 
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CLF Messages 


The CLF messages are issued to the TI device under which CLF is 


run. 
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This section discusses the messages which CLF can issue. 


#### BUFFERS READ 

#### RECORDS READ 

#### BUFFERS WITH OVERFLOW 
#### RECORDS LOST BY OVERFLOW 


Explanation: This statistics message is output at the 
completion of each run of CLF, indicating the statistics 
about the input file. 

User Action: None. 


#### FCS RECORDS WRITTEN 


Explanation: This statistics message is output when CLF 
produces an FCS output file. 


User Acton: None. 

DSW :####4# F.ERR:###### l10SB :###### FHRHE PC HPPA HE 
SP :##ttHE 

STK :###### FHPHHE 2 0e 

Explanation: This. is a status message which gives 
detail of the internal state of CLF at the time when an 
error is detected. This message is always followed by 
one of the messages discussed below, which describes the 
actual error condition. 

User Action: See action specified for the message 
issued immediately after this status message. 

COMMAND READ ERROR 


Explanation: An I/0 error occurred while reading the 
command line. 


User Action: Reenter the command. 


COMMAND SYNTAX ERROR 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 
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COMPLETION ERROR IN INPUT READ 

Explanation: an 1/0 error occurred while reading the 
input file. This condition, which may be symptomatic of 
a corrupted logfile, will be treated as end-of-file. 
User Action: Check F.ERR and IOSB for error cause, or 
use another logfile. 


ERROR ASSIGNING INPUT DEVICE 


Explanation: CLF was unable to assign a LUN to the 
input file. 


User Action: Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct. 
ERROR ASSIGNING OUTPUT DEVICE 


Explanation: CLF was unable to assign a LUN to the 
output file. 


User Action: Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct. 

ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 


Explanation: An I/0 error occurred when attempting to 
open a file on magtape. 


User Action: Ensure the drive is mounted foreign if 
logfile format is used for that file. Ensure the output 
drive is selectable, and not write locked. Correct the 
error indicated by DSW or IOSB. 

ERROR CLOSING INPUT FILE 


Explanation; An 1/0 error occurred when closing the 
input file. 


User Action: None. 
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ERROR CLOSING OUTPUT FILE 


Explanation: An I/0 error occurred when truncating or 
closing the output file. 


User Action: Correct the condition and rerun CLF, or 
manually unlock the output file. 

ERROR IN INPUT READ QIO 

Explanation: An I/0 error occurred while reading the 
input file. This condition, which may be symptomatic of 
a corrupted logfile, will be treated as end-of-file. 
User Action: Check DSW for cause. Rerun using another 
logfile if necessary. 


ERROR READING MPB 


Explanation: An I/0 error occurred when reading the 
first block of the logfile. 


User Action: Correct the condition and rerun. 


ERROR WRITING TO OUTPUT FILE 


Explanation: An I/0 error occurred when writing to the 
output file. 


User Action: Correct the condition and rerun. 


INPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the input 
filespec. 


User Action: Reenter the corrected command. 


INVALID DENSITY SELECTED, 800 OR 1600 ONLY 


Explanation: A magtape density other than 800 or 1600 
was specified. 


User Action: Reenter the command with a correct 
density. 
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INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to read a file not on 
disk or tape. Disk and tape are the only acceptable 
media for logfiles. 

User Action: Do not use CLF to read files not on disk 
or tape. 

INVALID MPB FOUND 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile, or a logfile produced by an incompatible 
version of COL. 


User Action: Use a different logfile. 


INVALID OUTPUT DEVICE TYPE 


Explanation: An attempt was made to write in logfile 
format to a device other than disk or tape. 


User Action: Only write logfile format to disk or tape. 
MORE THAN ONE INPUT FILESPEC NOT ALLOWED 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


MPB NOT FOUND - NOT TRACE FILE 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile. 


User Action: Use a different logfile. 
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OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the output 
filespec. 


User Action: Reenter the corrected command. 


OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile. 


User Action: Use a different logfile. 


TRUNCATED INPUT FILE RECORD 

Explanation: The end of a buffer was reached before all 
records in that buffer were processed. This indicates a 
corrupted logfile. 


User Action: Use a different logfile. 


UNABLE TO OPEN INPUT FILE 


Explanation: An I/0 error occurred while opening the 
input file. 


User Action: Correct the condition and rerun. 


UNABLE TO OPEN OUTPUT FILE 


Explanation: An I/0 error occurred while opening the 
output file. 


User Action: Correct the condition and rerun. 


UNKNOWN RECORD TYPE 


Explanation: An unknown record ID was found in the 
file. 


User Action: Use a different logfile. 
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CLF -- WILDCARD NOT ALLOWED IN FILESPEC 
Explanation: A wildcard was found in the command. 


User Action: Reenter the command without wildcards. 


3.2.6 Using OVL 


OVL is used to read a logfile and produce a report showing the 
disk resident overlay activity for a task. 


A memory-resident overlay segment is loaded from disk the first 
time that the segment is referenced. If a task has memory- 
resident overlays, OVL will count their initial loads in the 
overlay report. Subsequent memory-resident overlay "loads" 
will not be counted, since a disk load is not performed. 


OVL has two input files: 


1) A mapfile for the task whose disk resident overlays 
are to be analyzed. 


2) A logfile. 


In addition, the taskname switch /TS:tsknam must be appended to 
the logfile specification. If the taskname specified by 
/TS:tsknam is a generic taskname, e.g., ...XYZ, then all 
overlay hook records with the same generic taskname will be 
analyzed for the overlay report. If the taskname is not 
generic (not of the form ...XYZ), then only the hook records 
whose tasknames exactly match the /TS:tsknam taskname will be 
analyzed for the overlay report. 


The overlay report lists all the segment names for a task and 
prints the number of times each segment was loaded. 


In addition, you can trace each overlay load by using the /TR 
switch on the output file. As each overlay hook record is 
read, the segment name and the number of times that segment has 
been loaded up to that point will be printed. 


The command syntax for OVL is: 


>RUN OVL 
OVL> OUTFILE/SW = MAPFILE, LOGFILE/TS :tsknam 
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OVL Switches 


Switch defaults -- 
output: SY:TRACE.RPT/-TR 
input mapfile: SY:TRACE.MAP 


input logfile: SY:TRACE.LOG/DE :800/RW/SK :0 


Output Switches Description 


/TR /-TR Print a trace of each overlay segment, giving 
the segment name and the number of times the 
segment has been loaded up to that point. 


Input Switches 
(to logfile) 


/TS :tsknam This switch is required. If "“tsknam" is of 
the form ...XYZ, all hook records with same 
generic task name will be included for 
Overlay analysis; if "tsknam" is not of the 
form ...XYZ, then only hook records with 
tasknames exactly matching “tsknam" will be 
included for overlay analysis. 


/DE :nnnn Selects input magtape DEnsity, 800 or 1600 
(ignored unless /RW is all used) 


/RW /-RW Rewind tape input file before opening 


/SK nnn Skip nnn files when opening tape input file 
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OVL Messages 


The OVL messages are issued to the TI device under which OVL is 


run. 
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This section discusses the messages which OVL can issue. 


DSW :###### F.ERRi###### IOSB ###### #HAHHHE PC c## HH HF 
SP :###### 

STK :###### #HPHHE oe 

Explanation: This is a status message which gives 
detail of the internal state of OVL at the time when 
an error is detected. This message is always followed 
by one of the messages discussed below, which 
describes the actual error condition. 


User Action: See action specified for the message 
issued immediately after this status message. 
COMMAND READ ERROR 


Explanation: An I/0 error occurred while reading the 
command line. 


User Action: Reenter the command. 


COMMAND SYNTAX ERROR 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


COMPLETION ERROR IN INPUT READ 

Explanation: an I/0 error occurred while reading the 
input file. This condition, which may be symptomatic 
of a corrupted logfile, will be treated as 
end-of-file. 

User Action: Check F.ERR and I0SB for error cause, or 
use another logfile. 


ERROR ASSIGNING INPUT DEVICE 


Explanation: OVL was unable to assign a LUN to the 
input file. 


User Action: Check DSW and F.ERR for cause. Ensure 
the filespec syntax is correct. 
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ERROR ASSIGNING OUTPUT DEVICE 


Explanation: OVL was unable to assign a LUN to the 
output file. 


User Action: Check DSW and F.ERR for cause. Ensure 
the filespec syntax is correct. 

ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 


Explanation: An 1/0 error occurred when attempting to 
open a file on magtape. 


User Action: Ensure the drive is mounted foreign. 
Correct the error indicated by DSW or IOSB. 
ERROR CLOSING INPUT FILE 


Explanation; An I/0 error occurred when closing the 
input file. 


User Action: None. 
ERROR CLOSING OUTPUT FILE 


Explanation: An 1/0 error occurred when closing the 
output file. 


User Action: Correct the condition and rerun OVL or 
manually unlock the output file. 

ERROR IN INPUT READ QIO 

Explanation: An 1/0 error occurred while reading the 
input file. This condition, which may be symptomatic 
of a corrupted logfile, will be treated as 
end-of-file. 

User Action: Check DSW for cause. Rerun using 
another logfile if necessary. 


ERROR READING MPB 


Explanation: An 1/0 error occurred when reading the 
first block of the logfile. 


User Action: Correct the condition and rerun. 
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ERROR PARSING MAP FILE 


Explanation: OVL could not parse the specified file 
into overlay segment names and semgent block numbers. 


User action: Input a valid map file. 

ERROR PRINTING OVERLAY SUMMARY 

Explanation: An I/0 or formatting error occurred when 
attempting to print the summary section of the overlay 
report. 

User action: Correct the condition and rerun. 

ERROR PRINTING OVERLAY TRACE 

Explanation: An 1/0 or formatting error occurred when 
attempting to print the trace section of the Bun ay 
report. 

User action: Correct the condition and rerun. 
INCONSISTENCY BETWEEN MAP FILE AND LOG FILE 
Explanation: The overlay block numbers in the logfile 
for task epeehntss by /TS:tsknam do not appear in the 
map file. 

User Action: Be sure the map file is correct for all 
tasks in logfile with generic taskname specified by 
/TS :tsknam. 

INPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the input 
filespec. 


User Action: Reenter the corrected command. 
INVALID DENSITY SELECTED, 800 OR 1600 ONLY 


Explanation: A magtape density other than 800 or 1600 
was specified. 


User Action: Reenter the command with a correct 
density. 
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INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to read a file not 
on disk or tape. Disk and tape are the only 
acceptable media for logfiles. 


User Action: Do not use OVL to read files not on disk 
or tape. 


INVALID MPB FOUND 
Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 


User Action: Use a different logfile. 


MORE THAN TWO INPUT FILESPECS NOT ALLOWED 

Explanation: The command has improper syntax. 

User Action: Reenter the corrected command. 

MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 

Explanation: The command has improper syntax. 

User Action: Reenter the corrected command. 

MPB NOT FOUND - NOT TRACE FILE 

Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 

User Action: Use a different logfile. 


OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the 
output filespec. 


User Action: Reenter the corrected command. 
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OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 

User Action: Use a different logfile. 

TRUNCATED INPUT FILE RECORD 

Explanation: The end of a buffer was reached before 
all records in that buffer were processed. This 
indicates a corrupted logfile. 

User Action: Use a different logfile. 

UNABLE TO OPEN INPUT FILE 


Explanation: An I/0 error occurred while opening the 
input file. 


User Action: Correct the condition and rerun. 
UNABLE TO OPEN OUTPUT FILE 


Explanation: An I/0 error occurred while opening the 
output file. 


User Action: Correct the condition and rerun. 
UNKNOWN RECORD TYPE 


Explanation: An unknown record ID was found in the 
file. 


User Action: Use a different logfile. 
WILDCARD NOT ALLOWED IN FILESPEC 
Explanation: A wildcard was found in the command. 


User Action: Reenter the command without wildcards. 
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Writing User Information to the Logfile 


The performance of an application task can be measured 
by instrumenting the application task with a special 
directive and sub-function code: 

GIN$ 7,P1,P2,P3,P4,P5,P6,P7,P8. 


At each occurrence of this directive, the SPM-11M-PLUS 
performance monitor is invoked and a hook record of 
type H$USER is written to the logfile. The eight 
parameters Pl to P8 are binary words whose values can 
be set to any value the user desires. The hook record 
written to the logfile is specified in appendix A, 
Page A-28. 


The user can copy the logfile using CLF to obtain a 
logfile with H$USER records in FCS. variable length 
record format. Data reduction programs can then be 
written using the FCS record file as input. 


Example: 
GIN$C 7,100,200,300,400 ,500,600,700,1000 


will result in an H$USER record with parameters 100, 
200, 300, 400, 500, 600, 700, and 1000 written to the 
logfile. 


To dump a stream of H$USER records in a performance 
report, you run MDR and use the /DM:40 switch. If you 


only want the H$USER records dumped, the command 
syntax is: 


MDR> output = input/DM :40/LI :0/SI :0 

To copy a stream of H$USER records imbedded in a 
logfile with other record types, you can run CLF as 
follows: 


>CLF output /FCS:40 = infile. 
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CHAPTER 4 
DATA COLLECTION AND 
REDUCTION PROCEDURES 


COL and MDR are complementary tools which can be used to 
collect large amounts of performance data and interpret the 
data to a great degree of precision. Both COL and MDR have a 
number of parameters and switches which provide flexibility in 
both collecting and interpreting the data. In the following 
sections we describe how to utilize the parameters of COL and 
MDR to collect the best possible set of data to analyze your 
computer system. 


4.1 DATA COLLECTION PROCEDURE 


There are a number of questions you should answer before 
running COL to collect data: 


) Length and type of measurement interval? 

9) Resource types enabled for data collection? 
0 Device classes enabled for data collection? 
0 Tasks enabled for data collection? 


) System metrics enabled? 


Al Measurement Period 


The measurement period is defined as the time during which COL 
is collecting data. Typically this time is one continuous time 
interval; however, it may consist of a number of time intervals 
piecewise added together. 
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Under most conditions, you should select a continuous measure- 
ment period. This is done by running COL either in MANUAL mode 
or AUTOSTOP mode. 


MANUAL mode should be used when: 
fe) There is an operator available to terminate COL. 


0) You estimate the logfile space available is sufficient 
to contain all the data collected for the measurement 
period. 


AUTOSTOP mode should be used when: 
) An operator is not available to terminate COL. 


(0) You want to run COL for a fixed amount of time 
(AUTOSTOP on TIME). 


fe) You want to set a limit on the amount of logfile space 
used (AUTOSTOP on BUFFER). 


Under some conditions, particularly if the system is under 
heavy activity for long periods of time, COL will collect too 
much data given the available logfile space. To reduce the 
logfile space used, you can run COL in REPEAT mode. However, 
you should do so carefully. The chief concern when running COL 
in REPEAT mode is that “incomplete intervals" may result if a 
task or operation is outstanding exactly when COL starts or 
stops data collection. For example, if you start COL precisely 
when a task is active and has an I/0 operation queued to the 
disk, an incomplete interval will be flagged by MDR for both 
the task invocation and for the 1/0 operation. This condition 
does not invalidate other information in the performance 
report, it just “leaves out" some information which potentially 
may be valuable. You can minimize the number of incomplete 
intervals by minimizing the number of times COL enables or 
disables data collection for a measurement period. 


Let's say you want to collect data during a normal 8-hour 
daytime shift and you have only one 2400 foot magtape available 
for the logfile. However, you estimate that if COL runs all 
day, about two 2400 foot tapes will be needed. What you need 
to do is cut the amount of data collected in half. Consider 
the following alternative measurement schemes: 


0) Sample time = 1 minute; Time between samples = 
1 minute. 
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0) Sample time 
30 minutes. 


30 minutes; Time between samples = 


2 hours; Time between samples = 


0) Sample time 
2 hours. 


Scheme 1 will usually result in the highest number of 
incompletes, yet it probably will not “miss" any important 
system activity. Scheme 3 will probably result in the lowest 
number of incompletes, yet it is vulnerable to missing 
important intervals of system activity. Scheme 2 will probably 
result in a low number of incompletes, yet it has a good chance 
of capturing all periods of important system activity. 


What we're observing here is an old problem in communications 
systems: How fast do you sample a signal to be able to 
reconstruct the signal from the sampled data? In our case, the 
problem is: how fast do you sample the workload in order to 
reconstruct it? 


In communication systems, you sample the signal at twice the 
highest frequency in the signal. In computer systems, it would 
be reasonable to sample the workload at twice the highest 
frequency of variation in the workload. Thus if you observe 
the workload to fluctuate up and down about four times per 
shift, then 8 samples per shift (every 30 minutes) would reduce 
the amount of data and yet collect sufficient data to 
reconstruct the workload. 


4.1.2 Resource Types 


Normally you want to collect data for all resource types (CPU, 
memory, I/0). If the amount of data collected is too large, 
you can select one resource type per measurement period and run 
a number of measurement periods. 


The hooks are grouped according to resource type. To select a 
particular resource type, you select the corresponding hook 
group. 


4.1.3 Device Classes 


The device classes are: Directory, Sequential, Terminal, and 
Other. If you want to measure the resource contention for a 
device, select it for data collection. Normally the disks are 
shared devices and should be selected. If the line printer is 
spooled and attached to the despooler task you may not need to 
collect usage data for it. Similarly, terminals are normally 
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singly used by one task at a time; the measurement results may 
not be useful from a resource contention point of view. 


4.1.4 Tasks 


The tasks selected for data collection are the definition of 
the workload that you want to measure. For example, if you 
want to analyze the application workload, select all the tasks 
in that workload and deselect the system service tasks such as 
FI1ACP, MCR..., and QMG.... On the other hand, if you want to 
measure the system resources that a particular FLI1ACP is 
consuming, enable only F11ACP and disable all other tasks. 


4.1.5 System Metrics 


Normally system metrics should be enabled with a sample 
interval of 60 seconds. If you want to save logfile space and 
report paper, longer sample intervals may be used. 


4.2 DATA REDUCTION PROCEDURE 


Once you have a logfile on disk or tape, you are ready to read 
the logfile with MDR and reduce the data to a usable perfor- 
mance report. A guide to reading the performance report is 
given in Chapter 5. 


The data reduction procedure should consist of a number of 
steps methodically performed. A general guideline is to first 
obtain a number of overviews of the system activity during the 
entire measurement period and then print detailed analyses of 
the subset measurement intervals of interest. For example, if 
during an 8 hour shift there were two intervals of peak 
activity, from 9 to 11 a.m. and from 2 to 4 p.m., you should 
first run MDR with /LI:0 to get a system metrics scan of the 
entire 8 hour shift, and then run MDR with /AF and /BF to get a 
report of only the peak morning activity and again with /AF and 
/BF to get only the peak afternoon activity. The general 
procedure is as follows: 


0 Run MDR with /LI:0 for entire logfile. 
Identify the intervals of interest and record their 
endpoints of time using the KW11-P clock timestamps 
printed above the system metrics. 


6) Rerun MDR once for each subset measurement interval 
using /AF and /BF with tne /L1:2 switch. 
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This will give both system and task summaries. 
Identify the largest consumers of resources and record 
their tasknames. 


Rerun MDR with /LI:4 or /LI:5 and /TS for the tasks 
desired. 


Observe a detailed analysis of the particular tasks 


which consumed the resources and the times when these 
resources were consumed. 
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CHAPTER 5 
READING THE 
PERFORMANCE REPORT 


bad PERFORMANCE REPORT DATA 


When reading this section, refer to Appendix F, which contains 
a sample performance report. 


The performance report consists of four sections: 
) Measurement Parameters 
0) System Configuration 
0) System Metrics 


o) Task Metrics 


Salat Measurement Parameters 
The measurement parameters are read from the Monitor Parameter 
Block (MPB) which is the first block of the logfile. The MDR 
task extracts the information from it and prints the measure- 
ment parameters on the first page of the performance report. 
The items printed are: 

) Label. 

fe) Measurement mode. 

fe) Buffer type, partition, number and size. 

0 Resources selected for System Metrics. 

fe) TI filter device (if selected). 


0 Tasks selected for data collection. 


LZ) 0-1 READING THE PERFORMANCE REPORT 5-1 


0 Devices selected for data collection. 
(0) Hooks enabled. 


re) MDR command line 


5.1.2 System Configuration 


The system configuration information is contained in the 
Information Records and directly follows the MPB in the 
logfile. If the /SC switch is specified, the MDR task will 
extract the information from these records and print it to the 
logfile. The information printed is: 


) The primary pool (DSR) size in bytes, the executive 
feature mask words, and secondary pool size in 32 word 
blocks. 


0) A list of the partitions in the system when COL was 
activated. 


) A list of the controllers and units in the system when 
COL was activated. 


0 A list of the tasks installed in the system when COL 
was activated. 


0 A list of the active checkpoint files and their sizes 
when COL was activated. 


5.1.3 System Metrics 


The system metrics are system-wide measurements of CPU usage, 
pool usage, the usage of a selected partition, checkpoint file 
usage, and the usage of a selected device. Measurements are 
made for each sampling interval and the results written to the 
logfile. The length of the sampling interval is selected in 
the SMPGEN.CMD procedure. The system metrics are: 


0 CPU Usage 


For each sampling interval, counters are kept for the 
total times spent in kernel and idle states. The 
remainder of the sampling interval time is assumed to 
be user state. To depict CPU usage, a histogram is 
printed on the performance report. Each 1% of time 
spent by the CPU in user mode is represented by a 
single letter "U". Each 1% of time spent by the CPU 
in kernel mode is represented by a single letter "K". 
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The user time is left justified and grows from left to 
right; the kernel time is right justified and grows 
from right to left. If any blank spaces exist in the 
line, they represent CPU idle time. 


Pool Usage 


At the end of each sampling interval, COL scans the 
RSX-1L1M-PLUS primary and secondary pools and measures 
the percentage of each pool used. The percentage of 
pool used is represented by a histogram, where each 
"Pp" represents 1% of primary pool usage and each "S" 
represents 1% of secondary pool usage. 


Partition Usage 


The user selects a partition to be monitored via the 
COL switch /PR:parnam. At the end of each sampling 
interval, COL scans the partition data structures for 
the selected partition to measure the percentage of 
the memory in use in the partition. The percentage of 
memory used in the partition is represented by a 
histogram, where each "M" represents 1% of partition 
usage. 


Checkpoint File Usage 


When COL is activated, it scans the checkpoint file 
list and records a list of all active checkpoint files 
and their sizes. 


At the end of each sampling interval, COL scans the 
checkpoint file list and measures the percentage of 
all active checkpoint file space in use. If there is 
more than one checkpoint file, COL sums the space in 
all checkpoint files to compute the percentage. The 
percentage of checkpoint file space used is repre- 
sented by a histogram, where each "C" represents 1% of 
checkpoint file space uSage. 


Device Usage 


The user selects a device to be monitored via the COL 
switch /DV:ddnn. For each sampling interval, COL 
tallies all the I/0 request times for the selected 
device to get the percentage of time that the I/0 
device was in use during the sampling interval. The 
percentage of time the device was used is represented 
by a histogram, where each "D" represents 1% of device 
usage time for the sampling interval. 
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addition, if the device is a Files-11 disk and is 
mounted native, the number of disk blocks used on the 
volume is computed at the end of the sampling 
interval. The percentage of disk space used is 
represented by a histogram where each "B" represents 
1% of the total volume space used. 


For each sampling interval, the histograms for CPU, pool, 
memory, checkpoint file space, and device are clustered 
together into six successive lines on the report. 


The end of each sampling interval is timestamped and printed in 
two formats: KW11-P time and RSX-11M-PLUS system time. 


The KW11-P time is printed as two octal numbers: the left 
number is the high order part and the right number is the low 
order part. The corresponding RSX-11M-PLUS system time is 
printed as HRS :MIN:SEC.TENTHS. 


The KW11-P timestamp can be used to: 


) Correlate an individual task report page (which has 
the same form of timestamp) with a particular system 
metric line. 


) Select a particular measurement interval of interest 
by rerunning MDR using the /AF and /BF switches. 


The totals for CPU kernel time, CPU idle time and device busy 
time are given for each measurement interval. 


The last item in the system metrics section is the "Total Data 
Reduction Period". This is the total time for which data was 
reduced. If the report was generated using the /AF and /BF 
switches, only the data reduced between /AF and /BF is counted. 


5.1.4 Task Metrics 
Levels of Task Summarization 


The task metrics describe the usage of the resources in the 
system on a task-by-task basis. There are a number of levels 
of summarization available in the performance report, which 
enables the user to choose between a very detailed report or a 
shorter summarized report. The levels of summarization and 
their corresponding switches are as follows: 
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Individual Task Invocations (/L1:4 or /LI:5) 


An individual task invocation is defined as a single 
run of a task, that is, the time between an executive 
Run Task event and an executive Exit Task event (the 
exact placement of the hooks for these events is 
specified in Appendix A). A complete set of task 
metrics will be printed for each task invocation. If 
most or all tasks in the system are enabled for data 
collection, a report containing individual task 
invocations may be quite long. 


Task by TI Summary (/LI:3) 


In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) and the same TI are grouped together when the 
statistics are computed. The task metrics then reveal 
the measurements summed across all tasks with the same 
generic taskname from the same TI. 


Task Summary (/LI:2) 


In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) are grouped together when the statistics are 
computed. The task metrics then reveal the measure- 
ments summed across all tasks with the same generic 
taskname. 


System-Wide Summary (/LI:1) 


In this level of summary, the task metrics for all 
tasks in the system that were enabled for data 
collection are grouped together when the statistics 
are computed. The task metrics then reveal the 
measurements summed across all tasks in the system. 


Task Metric Data 


The following data is presented in the performance report for 
all levels of task summarization. 
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Generic TASK 
The generic taskname (see Chapter 2, Section 2.2.2) is 


printed on the top of the page to identify the task 
for which the data applies. 
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Elapsed Times 


The elapsed time is the time from a Run Task event to 
an Exit Task event. 


Number of Task Invocations 


The Number of Task Invocations is the number of times 
that a Run Task event occurred for the task. If the 
COL task is started while a task is in progress, the 
Run Task event will not be recorded in the logfile for 
that task. When the task exits, an Exit Task event 
will be recorded to the logfile. When MDR reads an 
Exit Task event without a corresponding Run Task 
event, it reports an “incomplete” invocation in the 
Number of Task Invocations line. 


Memory Times 
There are three memory times: 
- In (memory) 


- Out (memory) - includes time waiting for memory on 
initial task load and all time checkpointed 
(waiting and stopped). 


- Wait (memory) - includes time waiting for memory on 
initial task load and time checkpointed (waiting 
only). 


Memory Size in K Words 
Size of the task region. 
Space-Time Product 


The space-time product is the amount of memory that a 
task uses integrated over the time that the memory was 
used. Each increment of memory used (in K words) is 
multiplied by the time (in SECs) that the increment 
was used, and all products are summed to get the 
space-time product. If a task changes its size via an 
Extend Task directive, the corresponding change in 
memory usage is computed. 
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ACP Counts 


The ACP Counts are tallied across all ACPs in the 
system. They are not broken down by separate ACP. 


There are seven categories of ACP functions printed on 
the performance report. They are: 


- Access/Deaccess 
These functions are: Access File for Read, Access 
File for Read/Write, Access File for Read/Write/ 
Extend, Deaccess File, Connect Logical Link, and 
Disconnect Logical Link, and Close Out LUN. 

- Create/Delete 


These functions are: Create File, Delete File and 
Truncate’ File. 


- Read/Write 
These functions are: Read Virtual Block, Write 
Virtual Block, Receive Message and Transmit 
Message. 

- Directory 
These functions are: Find File Name in Directory, 
Enter File Name in Directory and Remove File Name 
from Directory. 

- File Attribute 


These functions are: Read File Attributes and Write 
File Attributes. 


- Extend 
This is the Extend File function. 

- Other 
These functions are all ACP functions other than 
those listed above, such as: Unlock Block, User 


Magtape Control Function and Network Control 
Function. 
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Memory Residency 


The Memory Residency count is incremented each time a 
task successfully allocates memory for an initial task 
load or for a checkpoint read. 


CPU Timeslices 


A CPU Timeslice is the time between a Load Task 
Context event and a Save Task Context event, minus the 
idle time accrued during that period. Note that if a 
task issues a directive and the processor switches to 
kernel mode, the corresponding time in kernel mode is 
charged to the active task's CPU timeslice. Also, if 
an interrupt occurs while a task's context is active, 
the corresponding kernel mode time is charged to the 
active task's CPU timeslice. 


Initial Loads 


Initial Loads is the number of Initial Task Load 
events for the task. The USAGE times indicate the 
time it took the loader task to load the task; the 
WAIT times indicate how long a task's load request was 
in the loader task's queue. 


Checkpoint R+W 


Checkpoint R+W is. the number of Checkpoint Read and 
Checkpoint Write events for the task. The USAGE times 
indicate the time it took the loader task to check- 
point (read or write) the task. (Note: the USAGE 
times do not indicate how long a task was check- 
pointed. This information appears under "Memory 
Times" on the task metric page.) 


DDnn Ovly Loads 


DDnn Ovly Loads is the number of overlay read (I0.LOV) 
QIOS the task issued to device DDnn. 


DDnn QIOs 


DDnn QIOs is the number of logical QIOs a task issued 
to device DDnn. Please note the following caveats: 


- DDnn Ovly Loads is included in this count, since 
IQ0.LOV is a Logical block QIO. 


READING THE PERFORMANCE REPORT 5-8 


- Task I0.RVB and I0.WVB (virtual) QIOs which are 
successfully and entirely mapped by the executive 
or F1l1ACP to I0.RLB and IO.WLB (Logical) QI0s are 
included in this count. a 


- Task I0.RVB and I0.WVB (virtual) QIOs which are 
sent to FIlI1ACP, and which are performed by F11ACP 
on behalf of the task (partially mapped, multiple 
transfers), are not included in this count. This 
logical block I/0 is charged to F11ACP. 


- The IO0.ATT, IO0.DET and IO.KIL QIOs are not included 
in this count. 


- Drivers for devices with the characteristic UC.QUE 
may directly process an I/0 request without the IRP 


being queued. This will cause an incomplete 
measurement of Usage and Wait times. (e.g., VT:, 
1h) 


USAGE Times 


The USAGE times indicate how long a task used a resource. 


WAIT Times 


The WAIT times indicate Ow long a task was waiting for the use 
of a resource. 


SERVICE Times 


The SERVICE time is the USAGE time plus WAIT time which 
occurred for each resource request. Note that the minimum 
SERVICE time is not necessarily equal to the minimum USAGE time 
plus minimum WAIT time, since the minimum USAGE time may have 
occurred for a different resource request than the resource 
request which had the minimum WAIT time. The same applies to 
the maximum. 


ARRIVALS PER SECOND 


The mean task rate is the number of resource requests issued by 
a task divided by the task‘'s elapsed time. It tells, from a 
task's point of view, the rate of resource requests issued by 
a task. The mean system rate is the number of resource 
requests issued by a task divided by the data reduction period. 
It tells, from a resource's point of view, the rate of resource 
requests issued by a task. 
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Resource Metrics 


For each resource used by a task, the following metrics are 
printed on the report: 
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Count 
The number of times a task used a resource. 
Total Time 


The total time during which a task used the resource 
(equal to the sum of all resource usage intervals). 


% Resident Time 
% Resident Time is (Total Time/Resident Time) * 100%. 
Minimum 


The smallest interval during which a task used a 
resource. 


Mean 


The arithmetic average of all resource usage intervals 
for a task. 


Maximum 


The largest interval during which a task used a 
resource. 


Coefficient of Variation 


The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval. 


% Resource 

% resource is the total time a task used the resource 
divided by the total time of the Data Reduction Period 
(total resource time available). 

Incomplete 

If the logfile does not contain a "complete" set of 
events needed to define an interval, MDR will tally 


the interval as an “incomplete". For example, if MDR 
reads a 1/0 Done event from the logfile for a certain 
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task and device and there is no corresponding Get I/0 
Packet event for the task and device, MDR will regard 
the I/0 interval as an incomplete. Incomplete 
intervals can occur if COL starts data collection 
while an operation (interval) is already in progress. 


The only data recorded for incomplete intervals is the 
count; no timing information is computed since the 
information is not precise. 


Incomplete intervals are printed in lieu of the % 
resource metric if the /IC switch is specified. 
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CHAPTER 6 
RESOURCES USED 
BY SPM-11M-PLUS 


The purpose of this section is to give an estimate of the 
resources used by the COL and MDR tasks. 
64:1 RESOURCES USED BY COL 

) CPU 


When a task metric hook is encountered, from 50 to 75 
instructions are executed at system level (PR=0, 
$STKDP=0) before returning to the main flow of the 
executive. 


0) Executive I-space 
Following a SYSGEN, SPM-1L1IM-PLUS occupies 
approximately 290 words of executive I-space. This is 
mainly accounted for by the hooks, hook dispatcher and 
the KW11-P handler. 

0) Primary Pool 


When the COL task is activated approximately 260 words 
of primary pool are used. 


) Physical Memory 
The COL task occupies about 3.5K words of physical 


memory. The COL buffers (either in a static common or 
dynamic region) can vary from 0.5K words to 32K words. 
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1/0 Requests 


The COL task issues a FCS WRITE$ to write a buffer to 
disk; it issues a QIO$ to write a buffer to magtape. 
The rate of I/0 requests generated by COL depends on 
the system activity that COL is tracing. 


RESOURCES USED BY MDR 


Memory 


The code and static data of MDR requires varying 
amounts of memory depending upon which version is 
BA Bes, See the TASK IMAGE SIZE in MDR.MAP. 
Additional space is required for 1/0 buffers and 
dynamic structures which are manipulated within MDR's 
virtual address space. MDR will automatically extend 
its virtual space as needed to accommodate these 
structures. Typically MDR will require an additional 
8KW for all the dynamic storage. 


Pool 


All MDR I/0 is singly buffered, and synchronous, 
minimizing the use of pool. 


I/0 


Each pass of MDR reads a single file and writes to the 
report file. During pass I the RESOURCE.TMP file is 
also being written. Terminal I/0 is used for command 
input, and error reporting. The DRS task will have up 
to 7 files concurrently opened for I/0. 
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CHAPTER 7 
SPM-11M-PLUS 
USAGE NOTES 


Ped TASKBUILDING COL 


COL must be linked to the supervisor-mode library [1,1]FCSFSL. 
This means that supervisor-mode support must be included in the 
system at SYSGEN. 


Tae COL BUFFERS 


When COL starts up it copies three system lists to the log 
file: 


1) TCBs 
2) PCBs 
3) DCBs-UCBs 


There must be enough buffer space to store the largest of these 
three system lists, otherwise COL will print the error message 
COLMSG -- INFORMATION RECORD ALLOCATION FAILURE. 


Before COL is left to run unattended for long periods of time, 
COL should be run for 5 to 10 minutes under a typical heavy or 
peak system workload and the console terminal should be 
monitored for the occurrence of overflow errors, i.e., COLMSG 
-- BUFFER OVERFLOW. If buffer overflows occur, the buffer size 
for COL can be increased by using the /BF switch (see Chapter 
35, Section 3.2.2)- 


Another cause of COL overflows may be small disk file extent 
sizes. When COL attempts to write a buffer to the Togfile, 
FI1ACP may have to do an extend file operation before the 
actual data write can be done. The time it takes F1IiACP to 
extend a file may be long, and COL may overflow as a result of 
this. To remedy this situation, two switches have been built 
into COL: 


9) Initial File Size /IF 
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If an estimate can be made of the maximum logfile size before 
COL is run, it is best to preallocate all the logfile space via 
the /IF switch. In this case COL will not need FI11ACP to do 
any extend file operations during its run and this may prevent 
overflows from occurring. 


fad STATE OF SYSTEM AT COL STARTUP TIME 


When COL starts up, it copies the TCBs, PCBs, DCBs and UCBs in 
RSX-11M-PLUS to the logfile. The MDR task later refers to 
these data structures to derive the necessary context for 
printing a performance report. 


To assure that MDR will have all the context it needs to print 
the report, you should insure that the following conditions are 
satisfied before starting up COL: 


0 All tasks installed 


If you want to disable a task for data collection, 
that task must be installed when COL starts up. Lt 
the system supports multi-user protection, then the 
following is true: if you disable a task of the form 

ee eXY¥Z, then all multi-user copies of that task will 
also be disabled for data collection. 


f°) All partitions set up 


If you want memory metrics kept for a partition, the 
partition must be set up 
(via SET /MAIN=XYZPAR :m:n :type) before starting COL. 


re) All drivers loaded 


If you want the I/0 metrics kept for a device-unit, 
the driver managing that device-unit must be loaded 
before starting COL. 


The MDR program is not capable of analyzing a logfile 
which contains task event records for an I/0 device, 
but no system configuration information for that 
device. To ensure that unusable logfiles are not 
created, no device driver database may be loaded while 
the task ...COL is active. 
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) All devices mounted 
If you want the correct ACP taskname for a mounted 
volume to be printed on the performance report, the 
volume must be mounted before starting COL. Other- 
wise, MDR will print a "pseudo" taskname for the ACP. 
Example: If the device DK1: is mounted to the F11ACP 
task after data collection is in progress for COL, MDR 
will print the pseudo name DK1***ACP on the report. 

) All checkpoint files allocated 
If you want the system metrics for checkpoint file 


usage, be sure to allocate all checkpoint files with 
the ACS command before starting COL. 


7.4 TASKBUILDING MDR 
MDR will run on processors with or without hardware FPP (float- 
ing point processor) support. If your processor does not have 
hardware FPP, it must minimally have hardware EIS instructions. 
You must taskbuild MDR to reflect the type of hardware (FPP or 
EIS) on your processor. You can build MDR either overlaid or 
non-overlaid with both FPP and EIS versions. To build MDR, 
invoke the build command file: 

>@MDRTKB 


This command file will prompt you to build any of the four 
available versions: 


1. FPP support, overlaid 
2. FPP support, non-overlaid 
3. EIS support, overlaid 


4. EIS support, non-overlaid 
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You can change certain MDR defaults by editing the taskbuild 
command file produced by MDRTKB.CMD. The comments in the MDR 
build file will prompt you for changing the defaults. The 
defaults which can be changed are: 


0 Number of lines per page in REDUCE.RPT file 
fe) Default value for /LI switch 

0 Default value for /SI switch 

fo) Default magtape logfile density (/DE) 

f°) Default value for /DM switch 

fc) Whether MDR automatically spawns DRS 


fe) The maximum unit number of a VT in the measured system 


7.5 MAXIMUM VT: UNIT NUMBER SUPPORTED BY MDR 


MDR has the capability to process the dynamic creation and 
deletion of virtual terminals during a period of data 
collection. One aspect of the implementation of this feature 
is that MDR must pre-allocate the data structures which 
describe all the VTs while processing the I$UCB for VTO:. Thus 
on a system with no VT: support these structures will not be 
allocated. Although device unit numbers may range from 0 to 
377 (8), RSX-11M-PLUS always assigns the lowest possible unit 
number to a newly created VT:. Since each such data structure 
used by MDR requires 6 words, allowing for 377(8)VTs would 
require more than 1.5 K Words of MDRs virtual space. To 
reduce this excessive use of space to a much smaller value, 
40(8), is used as the maximum VT: unit number which MDR will 
recognize. Should this prove insufficient, MDR may be rebuilt 
with the parameter MAXVT increased. 


7.6 PERFORMING REDUCTION UNDER BATCH 


MDR may not be run in BATCH if any of the switches /NT, /NU, 
/TS, or /UC is used. This occurs because MDR uses “read with 
prompt" to obtain the filter parameters, but the VT: driver 
does not support this function. Since I/0 error at terminals 
are often correctable, or due to operator error (break key), 
MDR will repeatedly retry I/0 which the VT: driver does not 
Support. This causes an endless loop. 


Manual intervention to run the DRS pass is impractical when 
running MDR under a batch processor. 
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The tasks CLF, DRS, and MDR terminate their execution via the 
EXIT$ directive. This implies that the resulting status will 
always be EX$SUC even when an error occurs. 


7.7 NECESSARY UFD TO RUN MDR 
The intermediate files used by MDR will always be created in 


the directory SY:[current UIC]. Therefore to run MDR, this 
directory must exist, on a mounted Files-11 disk. 


7.8 DEVICES FOR TI: FILTER 
All devices which are specified in the MDR TI: filter (/NU or 
/UC) must be known to MDR via the I$UCB records. Thus to use a 


VT: in this filter, the VT: (or BATCH Processor) must be 
created before starting data collection. 


7.9 MANUALLY EXECUTING THE DRS PASS 

MDR cannot determine whether DRS has completed successfully or 

with errors. If errors are likely in this pass (e.g., available 

disk space is minimal) manual intervention to execute the DRS 

pass may be desirable. MDR will issue instructions for this 
manual operation if either of the following two conditions are true: 


) MDR is built with the GBLPAT which prevents automatic 
spawn of DRS 


0) The task ...DRS is not installed when MDR is running. 


7.10 TASKBUILDING CLF 
Generally CLF need not be taskbuilt since it is supplied as a 
task image. However to change defaults or apply patches, the 
build command file is invoked: 

>@MDRTKB 
The defaults which may be changed are: 


0) default magtape density 


) default value of the /FCS:nn switch 
(if specified as /FCS) 
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7.11 POSSIBLE HANGING OF CLF 
If CLF is writing an FCS output file to the null device (NL:), 
and no records are actually written, CLF will hang in WAITFOR 


state when attempting to close the output file. To recover 
from this error, it is necessary to abort CLF. 


Pave USE WITH LAYERED PRODUCTS 

SPM-11M-PLUS inserts hooks into the RSX-11M-PLUS executive at 
Standard places where the executive does allocations and 
deallocations of resources. 

SPM-11M-PLUS measures kernel CPU time by hooking the standard 
interrupt save ($INTSV, $INTSE, $INTSC) and system exit 
($DIRXT) points. 

If any layered product or user privileged: component uses 
nonstandard techniques for resource allocation or interrupt 
entry, the SPM-11M-PLUS measurements will be inaccurate. 


For example, DECNET uses a nonstandard interrupt save routine, 
which means the kernel CPU time measurement will be inaccurate. 


i213 REPORTING PROBLEMS AND ERRORS 


A Software Performance Report (SPR) is used to report problems, 
errors, or suggested enhancements concerning SPM-11M-PLUS. 


Whenever possible, the following information should be 
submitted with the SPR: 


fe) A map of the failing component 

) The MPB source file (TRACE.PAR) 

) The logfile on Magtape (TRACE.LOG) 

o The faulty performance report (REDUCE.RPT) 
) The faulty CLF output file on Magtape 

fc) The faulty OVL output file. 


All media will be returned. 
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APPENDIX A 
HOOK RECORD 
DEFINITIONS 


NOTE: All record offsets in this appendix 
are expressed in octal bytes. 


All record lengths are expressed in 
decimal bytes. 


HOOK RECORD DEFINITIONS A-1 


1.0 


Lad 


1.2 


Tweed 


1.2. 
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H$CDRP ~ CALL DIRECTIVE PROCESSOR 


LOCATION 
DRDSP.MAC 
After $EMTRP: :DIRSV$ 
After 50$: MOV R5,R2 
Follow MOV $HEADR ,R4 


DATA COLLECTION 
Storage Dependencies - 


$TKTCB (Current Task TCB) 
$DICSV (Directive ID Code) 


Record Format - 


Hook I.D 0 


Timestamp 2 
Taskname (RAD50) 6 


TI UCB Address 12 


14 


Record Length - 


14. bytes. 


HOOK RECORD DEFINITIONS 


2.0 H$RTSK - REQUEST TASK TO RUN 


Zeal LOCATION 


REQSB.MAC 
After $TSKRP:: 
After 1$: 
Follow MOV R23 FUER (RO 


2.2 DATA COLLECTION 


2eted Storage Dependencies - 


RO=TCB address 


2202 Record Format - 


Hook I.D. 0 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


Request UIC 14 


2.223 Record Size - 
14. bytes. 
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3.0 


i2fel 


H$XTSK = TASK EXIT 


LOCATION 
DREIF.MAC 
After SCEXIT = 3 
Follow 130$: MOV $TKTCB,RO 


DATA COLLECTION 


Storage Dependencies - 


$TKTCB=TCB address 


Record Format - 


Hook I.D. 0 


Timestamp 2 
Taskname (RAD50): 6 


TI UCB Address 12 


Idletime 14 


Record Length 


16. bytes. 


HOOK RECORD DEFINITIONS 


4.0  H$SCTX - SAVE CONTEXT OF TASK 


4.1 LOCATION 


SYSXT.MAC 
After RESCH: CLR @$RQSCH 
Follow 73$: MOV H.GARD(R3) ,R2 


4.2 DATA COLLECTION 


4.2.1 Storage Dependencies - 


$TKTCB (Current Task TCB) 


4.2.2 Record Format - 


Hook I.D. 0 


Timestamp 2 
Taskname (RAD50) 6 


TI UCB Address 12 


Idletime 14 


4.2.3 Record Length 


16. bytes 
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5.0 
5.1 


Dae 
Sted 


Daene 


Dates 
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H$LCTX - LOAD CONTEXT OF TASK 


LOCATION 
SYSXT.MAC 
After RESCH: CLR @$RQSCH 
Follow 120$: MOV H.GARD(R2) ,R 


DATA COLLECTION 


Storage Dependencies - 


$TKTCB (Current Task TCB) 


Record Format - 


Hook I.D 0 

; 

Taskname (RAD50) 6 
TI UCB Address 12 
14 


Idletime 


Record Length 


16. bytes 


HOOK RECORD DEFINITIONS 


0 
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H$USTP - UNSTOP 


LOCATION 
REQSB.MAC 


After 
Follow 


DATA COLLECTION 


Storage Depen 


RO=TCB addres 


TASK 


$EXRQN: :BIT #12551 PF 212A STP elas 2 
BIC PIQ.S bP E21 2e51 Py hs she 


dencies - 


S 


Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


12 


Record Length - 


IZe D¥TeSs 


HOOK RECORD DEFINITIONS 


RO 
(R 


) 
0) 


7.0 H$QAST - QUEUE AST TO TASK 


EA LOCATION 
REQSB.MAC 
After $QASTT: :ADD #T.ASTL,RO 
Follow BEQ 5$ 
REQSB.MAC 
After $QUEXT:: 


Follow Mov R2, RO 
i ee DATA COLLECTION 


Y ee an Storage Dependencies - 


RO=TCB address 


7202 Record Format - 


0 
Timestamp 2 
Taskname (RAD50) 6 

12 


TI UCB Address 


y ares Record Length - 
12. bytes. 
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Lepet 


H$EXTK - EXTEND TASK 


LOCATION 


DREXP.MAC 
After $DREXP:: 


Follow Yio MOV R1,P.SIZE(RO) 


DATA COLLECTION 


Storage Dependencies - 
$TKTCB=TCB address 
RO=PCB address 


Record Format - 


Hook I.D. 
leanne 


Taskname (RAD50) 


TI UCB Address 
Partition Size (P.SWSZ) 


Record Length - 


12 


14 


14. bytes. 
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9.0 H$QPAR - QUEUE REQUEST FOR PARTITION 


9.1 LOCATION 
REQSB.MAC 


After $TSKRP:: 


After 4$: 
Follow MOV R3,R1 


9.2 DATA COLLECTION 


93251 Storage Dependencies - 


R1l=PCB address 


a 3? Record Format - 


Hook I.D. 0 

Timestamp 2 

Taskname (RAD50) 6 
i? 


TI UCB Address 


cP Are: Record Length - 
12. bytes. 
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10.1 


10.2 


103261 


10.2.2 


10.2.3 
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H$QLDR - QUEUE TASK LOAD REQUEST TO LOADER QUEUE 
LOCATION 
REQSB.MAC 


After $LOADT:: 
Follow 50$: MOV $LDRPT ,RO 


DATA COLLECTION 


Storage Dependencies - 


R1=PCB address 


Record Format - 


Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
14 
Ps STAT 16 


Record Length - 


16. bytes. 


HOOK RECORD DEFINITIONS 


11.0 H$GLDR - GET REQUEST FROM LOADER QUEUE 


Llet LOCATION 


LOADR.MAC 
After $LOADR::CAl11 $SWSTK,40$ 
Follow 5$: MOV R1, R3 


11.2 DATA COLLECTION 


Lig? Storage Dependencies - 


R1=PCB address 


11.2.2 Record Format - 


Hook I.D. 0 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


bhe2s3 Record Format - 


12. bytes. 
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12.0 


12.1 


L2e2 


L202 ok 


1262%2 


I Ae an 
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H$FLDR - FINISH LOADER REQUEST 


LOCATION 
LOADR.MAC 
After $LOADR: :CA11 $SWSTK ,40$ 
Follow 81$: CA11 $SWSTK,$LOADR 


DATA COLLECTION 


Storage Dependencies - 


R4=PCB address 


Record Format - 


0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 


Record Length - 


12. bytes. 


HOOK RECORD DEFINITIONS 


13.0 H$RLPR - RELEASE PARTITION 
L341 LOCATION 


REQSB.MAC 
After $RLPAR:: 
Follow BNE $NXTSK 


L362 DATA COLLECTION 


Toetet Storage Dependencies - 
Rl = PCB address 
13.2.2 Record Format - 


Hook ID 0 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


14 


133203 Record Length - 


14. bytes. 
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14.0 


14.1 


14.2 


14.2.1 


“Lases2 


14.2.3 


12/81 


H$QDRV - QUEUE I/0 PACKET TO DRIVER 


LOCATION 


DRQIO.MAC 
After $DRQIO:: 
Follow $DRQRQ::MOV 


DATA COLLECTION 
Storage Dependencies - 
R1=IRP address 


R5=UCB address 


Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


UCB Address 


Function code 


IRP Address 


Record Length - 


20. bytes. 


LZ 


14 


16 


20 


22 


U.SCB(R5) ,R4 


HOOK RECORD DEFINITIONS 


15.0 


L5<.1 


£02 


ey are 


15.2.2 


Loe7e 
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H$GPKT - DRIVER OR ACP GETS AN I/O PACKET 


LOCATION 
IOSUB.MAC 
After $GTPKT: 
After 1273.2 
Follow 


DISPAT.MAC (F11ACP) 


After 
Follow 


DATA COLLECTION 


Storage Dependencies - 


R1l=IRP address 


Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


IRP Address 


Record Length - 


14. bytes. 


~START:: 


MOVB U.UNIT(RS5) ,R2 


MOV $HEADR ,R5 


12 


14 


HOOK RECORD DEFINITIONS 


16.0 H$IODN - I/0 DONE PROCESSING 


16.1 LOCATION 


TOSUB.MAC 
Follow $IODON::MOV U.SCB(R5) ,R4 


16.2 DATA COLLECTION 


16.2.1 Storage Dependencies - 


R4= SCB Address 


16.2.2 Record Format - 


0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
| IRP Address 14 


165253 Record Length - 
14. bytes. 
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17.0 H$IOFN =~ COMPLETE 1/0 POST PROCESSING 
17.1 LOCATION 
IOSUB.MAC 
Follow $I0FIN:: 


Taz DATA COLLECTION 


Ay are Storage Dependencies - 


R3=IRP.address 


17.2.2 Record Format - 


Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
14 


IRP Address 


Lis263 Record Length - 


14. bytes. 
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18.0 


H$QAC1 - QUEUE I/0 PACKET TO ACP 


18.1 LOCATION 


18.2 


Les2%4 


16.242 


13233 
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DRQIO.MAC 
After $DRQIO: 


Follow MOV U.ACP(RS5) ,RO 


DATA COLLECTION 


Storage Dependencies - 


R1=IRP address 


Record Format - 


Hook I.D. 0 
lee 
Taskname (RAD50) 6 
TI UCB Address 12 
UCB Address 14 
Function Code 16 
20 
22 


IRP Address 


Record Length - 


20. bytes. 
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19.0 


Lod 


T9352 


Leek 


49.22 


19 e263 
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H$QAC2 - QUEUE 1/0 PACKET TO ACP 


LOCATION 
IOSUB.MAC 
After $GTPKT:: 
Follow 95$: 


DATA COLLECTION 


Storage Dependencies - 


R1=IRP address 


Record Format - 


Hook I.D. 0 

Timestamp 2 

Taskname (RAD50) 6 
TI UCB Address 12 
UCB Address 14 
Function Code 16 
~ 
22 


IRP Address 


Record Length - 


20. bytes. 


HOOK RECORD DEFINITIONS 


20.0 
20.1 


20 e 


20.2.1 


202282 


20.2.3 
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H$CRVT - CREATE VIRTUAL TERMINAL 


LOCATION 
DRCRV.MAC 
After $DRCRV:: 
After 70$: 
Follow MOVB D.UNIT(R1) ,2(SP) 


DATA COLLECTION 
Storage Dependencies - 
R1=DCB address 


Record Format - 


I$CVT 0 
UCB Address 2 
4 


Record Length - 


6. bytes. 


HOOK RECORD DEFINITIONS 


21.0 


211 


21.2 
Zlvéel 


21.2.2 


ehutad 
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H$ELVT - ELIMINATE VIRTUAL TERMINAL 


LOCATION 


DRCRV.MAC 
After $DRCRV:: 


Follow $DEAVT:: | MOV (RO) ,RO 


DATA COLLECTION 
Storage Dependencies 


RO =. DCB Address 


Record Format 


Unit Number 


Record Length - 
4. bytes. 


HOOK RECORD DEFINITIONS 


A-22 


22.0 H$OVLY - LOAD OVERLAY 


2241 LOCATION 
DROIO.MAC 
After $DRQIO:: 
Follow BNE IEOVR 
Zeee DATA COLLECTION 
Coeewl Storage Dependencies - 


R4 = <Address +2> of Overlay Relative Block Number 


ee eae are Record format - 


==] 
ee] 
[ee | 

14 


Relative Block Number 


LOs0s3 Record Length - 


14. bytes. 
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23.0 


(ae ea 


2342 
23.2.1 


2325.2 


aes Se ares, 
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H$SYEN - SYSTEM ENTRANCE 


LOCATION 

SYSXT.MAC 

After $DIRSV:: 

Follow MOV SP,@$HEADR 
SYSXT.MAC 

After $INTSI:: 

Follow MOV SP, @$HEADR 
SYSXT.MAC 


After SINTSC 
Follow MOV SP, @$HEADR 


DATA COLLECTION 

Storage Dependencies - 

None 

Routine - 

Timestamps system entrance time $BSTIM. 
Record Format - 


None 


HOOK RECORD DEFINITIONS 


24.1 


24.1.1 


24.132 


24.1.3 
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H$SYXT - SYSTEM EXITS TO USER TASK 


LOCATION 
SYSXT.MAC 
After $DIRXT:: 
After 9$: MOV (SP)+,R0 
Follow MOV (SP)+,R3 


Storage Dependencies - 

None 

Routine - 

Copies current clock time, subtracts system entrance 
time ($BSTIM), and adds the resulting delta time to 
the total system time $TSTIM. 


Record Format - 


None 


HOOK RECORD DEFINITIONS A-25 


25.0 
209. 


Cue 
Cosded 


dene 


2080.3 
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H$EIDL - ENTER EXECUTIVE IDLE LOOP 


LOCATION 
SYSXT.MAC 
After RESCH: 
After 30$: 
Follow CLRB @$CURPR 


DATA COLLECTION 
Storage Dependencies - 
None 
Routine - 
Copies current clock time, subtracts the system 
entrance time ($BSTIM), and adds the resulting delta 
time to the total system time $TSTIM. Timestamps idle 
entrance time $BIDLE. 
Record Format - 


None 
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26.0 


265.2 
204.2 6k 


262262 


2647249 
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H$XIDL - EXIT EXECUTIVE IDLE LOOP 
LOCATION 
SYSXT.MAC 
After $QFORK:: 
Follow CLRB $IDLFL 
DATA COLLECTION 
Storage Dependencies - 
None 
Routine - 
Copies current clock time, subtracts the idle loop 
entrance time ($BIDLE), and adds the resulting delta 
time to the total idle time $IDLE. Timestamps system 
entrance time $BSTIM. 


Record Format - 


None 
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27.0 


fad 


oiler 
27.2.1 


BIR 


2d sted 
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H$USER - USER INFORMATION HOOK 


LOCATION 
DRGIN.MAC 
Follow $SFPMN:: 
DATA COLLECTION 
Storage Dependencies - 


-$TKTCB (Current Task TCB) 
R3 = Address of DPB 


Record Format - 


Hook I.D. 0 


Timestamp 2 
Taskname (RAD50 6 


TI UCB Address | 12 
GIN$ Parameter 14 
GIN$ Parameter 16 
GIN$ Parameter 20 
GIN$ Parameter 22 
GIN$ Parameter 24 
GIN$ Parameter 26 
GIN$ Parameter 30 


GINS Parameter 8 32 


Record Length - 


28. bytes. 


HOOK RECORD DEFINITIONS 


A-28 


APPENDIX B 
MPB DEFINITION 


Monitor Parameter Block 
The Monitor Parameter Block (MPB) is the data structure which 
contains the measurement parameters. These measurement 
parameters are defined by invoking the procedure @SMPGEN.CMD, 
which produces: 

) The binary MPB file (filename.MPB) 

fe) The source MPB file (filename.PAR) 

0) The MPB saved answer file (filename.CMD) 


The COL task reads the MPB and initializes its databases from 
the MPB. 


The length of an MPB in bytes is M.LGTH (defined by MPBDF$ in 
HKMAC .MAC ) 


The MPB has the following format and contents: 


Parameter Offset Size(wds) Values 
MPB ID word (I1$MPB) M.PID 1 I$MPB 
Measurement label M.LABL 32. 

Buffer Type M.BTYP 1 DYNAMIC=0 

STATIC=1 

Buffer Count M.BCNT 1 

Buffer Size (bytes) M.BSIZ if 

Buffer Size (64b blk) M.BS64 1 
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Parameter 

Buffer Partition Name 
SYS Partition Name 
Buffer Partition Addr. 
Buffer Partition Size 
Buffer Partition Flags 


Measurement Mode 


Sample Count (Buffers) 
Sample Interval Mag. 
Sample Interval Units 
Repeat Count 

Repeat Interval Mag. 
Repeat Interval Units 
Hook Bit Table 

1/0 Selection Word 


Other Devices Sel. Word 


Device Class Mask 


Device Selection Mask 


Sys. Metrics Samp. Int. 


Sys. Metrics Partition 
Sys. Metrics Device 

TI Filter Device 

TI Filter Device Num. 
MPB Validation Word 
Task Selection Mask 


Task Selection Table 
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Offset 
M.BPAR 
M.BPNM 
M.BPAD 
M.BTSZ 
M.BFLG 
M.MODE 


M.SCNT 
M.SINT 
M. SUNT 
M.RCNT 
M.RINT 
M.RUNT 
M.HTBL 
M.IOS 
M.OTHR 
M.CW1M 
M.CW1S 
M.SAMP 
M.PART 
M.DEVC 
M.TIDV 
M.TINM 
M.VALD 
M.TKS 
M.TTBL 


MPB DEFINITIONS 


Size(wds) Values 


2 
Z 
1 
1 


1 MANUAL=0 
AUTOSTOP=1 
REPEAT=2 


d P$$VER 


APPENDIX C 
INFORMATION RECORD 
DEFINITIONS 


Information Record 

The Information Record provides system context data which can 
be correlated with the Hook Records to identify tasks, 
partitions, and I/0 device-units. 


In addition, there are Information Records which capture 
essential data when COL starts and stops data collection. 


For lengths of the following data structures, see the macro 
IBDEF$ in HKMAC.MAC. 


I$SYS - System Common Information 


I$sys eG 
Initial Pool Size a 
$FMASK 4 
$FMASK+2 6 


Sys. Met. Dev. UCB Address 10 


SEC Pool Partition Size 12 
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I$TCB - Task Control Block 


I$TCB 0 
I$TCB Record Size Z 
TCB Address 4 
TCB Contents 6 
I$PCB - Partition Control Block 

0 
I$¢PCB Record Size "ae 
PCB Address 4 

6 


PCB Contents 
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I$DCB - Device Control Block 


I$DCB 0 
I$¢DCB Record Size 2 
DCB Address 4 
DCB Contents 6 
I$UCB - Unit Control Block 

I$UCB 0 
I1$UCB Record Size “2 
UCB Address 4 

6 


UCB Contents 
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I$CKP - Checkpoint File Information 


I$CKP 0 


CKP. File Device UCB Addr. 2 


CKP. File Size 4 


I$TMR - Start Data Collection 


0 
System Time (Year) 2 
System Time (Month) 4 
System Time (Day) 6 
System Time (Hour) “40 
System Time (Minute) 12 
System Time (Second) 14 
System Time (Tick) 16 
Ticks Per Second 20 
High KW11-P Time 22 
Low KW11-P Time 24 
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I$¢STM - Stop Data Collection 


I$STM 0 

System Time (Year) 2 

System Time (Month) 4 

System Time (Day) 6 

system Time (Hour) 10 
System Time (Minute) 12 
System Time (Second) 14 
System Time (Tick) 16 
Ticks Per secona 20 
High KW11-P Time t S22 
Low KW11-P Time 24 
CPU Kernel Time (High) 26 
CPU Kernel Time (Low) 30 
CPU Idle Time (High) 32 


CPU Idle Time (Low) 34 


Device Usage Time (High) 36 


Device Usage Time (Low) 40 
Ui ee 
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APPENDIX D 
SYSTEM METRICS 
RECORD DEFINITION 


System Metrics Record 


The System Metrics Record contains data which represents the 
System-wide usage of the CPU, pool, a selected memory 
partition, checkpoint file space, and a selected device. 
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High KW11-P Time 


sateen A SRS 


Low KW11-P Time 


CPU Kernel Time (High) 


CPU Kernel Time (Low) 


CPU Idle Time (High) 


CPU Idle Time (Low) 
# Free Pool Nodes 
Total Free Pool Space (bytes) 


Smallest Pool Node (bytes) 


Largest Pool Node (bytes) 


Main Partition PCB Address 
Number of Subpartitions 
Total Space Used (32W biks) 


Total CKP.File Space 


Total CKP.File Space Used 


UCB Address of Device 


eect enenenemnnieetininainttn tinct 


Device Usage Time (High) 


Device Usage Time (Low) 
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Free Disk Blocks (High) 
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Free Disk Blocks (Low) 
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SEC Pool Free (32 W blks) 
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36 


40 
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APPENDIX E 
LOGFILE FORMAT 


1.0 DISK LOGFILE FORMAT 


A logfile on disk is a Files-11 file with the following format: 


VBN 
1 
‘BUFFER 
#1 
N 
N+1 BUFFER 
#2 
2N 
BUFFER 
#M 
M*N 
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Each BUFFER has the following general format (byte 
offsets): 


Record Count 0 

Overflow Count 2 

x$xxx is I$, H$ or 
S$ record ID. 


See appendices 
A, B, C and D. 


Unused Space 
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All BUFFERS are the same length. The BUFFER size in 512B 
blocks is derived from the BUFFER size in bytes which is 
stored in the MPB in BUFFER #1: 


BUFFER #1 Format (byte offsets) 


Record Count 0 
2 
4 Note: 
I$MPB is the 1st record; 
I$SYS is the 2nd record; 
x$xxx is I1$, H$ or S$ 
record ID. 
See appendices 
A, B, C and D. 
4+M.BSIZ 


GO 


Unused Space 
BUFFER size (blocks) = BUFFER size (bytes) 
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2.0 MAGTAPE LOGFILE FORMAT 


A magtape can contain one or more logfiles. Each BUFFER is 
terminated by an IRG. Each logfile is terminated by a tape 
mark (EOF). The magtape is terminated by a double tape mark 
(EOF EOF). Each BUFFER has the same format as for disk. 


BUFFER 
#1 


' BUFFER 
#M1 


end of logfile #1 


BUFFER 
#1 


BUFFER 
#Mn 


| EOF | end of logfile #n 


end of tape 
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3.0 FCS LOGFILE FORMAT 


The CLF utility task can be used to convert a logfile from the 
formats specified in section 1.0 and 2.0 to a file containing a 
stream of variable length FCS records. Each FCS record 
contains one record of type H$xxxx, I$xxxx or S$xxxx. The 
first word of each record contains the record ID, H$xxxx, 
I$xxxx or S$xxxx. The record formats are specified in 


Appendices A, B, C and D. 


See Chapter 3, Section 3.2.5 for using CLF. 
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APPENDIX G 
EXAMPLE SMPGEN 


@SMPGEN 
>F 
>oREK Software Monitor Parameter GENeration command file xxx 


> XkX Version 401 kkk 

‘ Copyright (C) 198171982 Digital Eauiement Corrporationr Maynards Mass. 
> 

>e Initialize default rarameters 

> READ SAVED ANSWER FILE FOR DEFAULT ANSWERS? CY/NIiN 

> Select rarameter category» tyre <esc> for help 

> ENTER PARAMETER CATEGORY CS1:- 


LEGAL PARAMETER CATEGORIES ARE ¢ 
HOOK TASK MODE LABEL 
BUFFER DEVICE SYSTEM DONE 


ENTER PARAMETER CATEGORY €S1]? HOOK 


nh OW As 


Select/deselect hook points 


voy 


CPU USAGE HOOKS? CY/NI?Y 

MEMORY USAGE HOOKS? CY/NIiN 

I/O DEVICE USAGE HOOKS? CY/NIiY 

USER INFORMATION HOOK? CY/NIiN 

LOAD OVERLAY HOOK? CY/NI3Y 

CALL DIRECTIVE PROCESSOR HOOK? CY/NIiN 


nt 


ye 


Select parameter catedory, type <esc> for hele 


wow Oo ee 


ENTER PARAMETER CATEGORY CS]: BUFFER 


ed 


Setup buffer management rarameters type <esc> for hele 


FE ar ee ee SE ar ver ae HE FE BE FE ME FE ep <=> ar BE ee ar wee er er SE ar WO ar BE Ge ee ee “ar ao “as “ar wo 


Mow 


ENTER BUFFER TYPE COSDYNAMIC] CS R30-713 

~* ENTER NAME OF BUFFER MAIN (SYS) PARTITION CDiGEN] CS Ri0-61% BUFPAR 
>* ENTER NAME OF BUFFER COMMON/REGION CDi TRCPARI] CS R30-613 

>*% ENTER NUMBER OF BUFFERS CD Ri2.-8. Bi2.13 4 

2k ENTER BUFFER SIZE IN 512B BLOCKS CD Rti.-16. Di8.J3" 


>? Select parameter catesorys tyre <esc> for hele 
>* ENTER PARAMETER CATEGORY [CS13 TASK 


>» Select/deselect tasks to be traced 
TO YOU WANT TO TRACE ALL TASKS? CY/NI3 
nO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? CY/NIS3Y 


Enter one taskname rer line. Terminate list by <CR>. 


ENTER NAME OF TASK NOT TO TRACE £813 -F1i1lACcP 
ENTER NAME OF TASK NOT TO TRACE CS13 MCR..- 
ENTER NAME OF TASK NOT TO TRACE £S]3 QMG... 
ENTER NAME OF TASK NOT TO TRACE CS]: LPPO 

ENTER NAME OF TASK NOT TO TRACE £833: TKTN 

ENTER NAME OF TASK NOT TO TRACE CS] -F11MSG 
ENTER NAME OF TASK NOT TO. TRACE CS]! MTAACP 


WO SO 
Be RM wee wr wr 2 MH we 


wow fy 


a Y 
Me 2 


ese 


ay 
cd 
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WON ee 


i a a i a 


PNP EO OE OO OO 


eh 


st 


MP OE EE OE NEO OE OO OO 


wow 


sen Sem ech DG hao! tas "sani iG iseh “96 5a HELD: nab: See Sab Ras NSS San SRE“ O DE SE: SE SEs See en nen Sab BE GG ae tab: ae sen nab: SG Sob. a8 gE DEL DUR! sabia! PE. DELPEUSE eiecnsen SESE. Neg/har ep Ome 


woo oY 


ENTER NAME OF TASK NOT TO TRACE CSJi,..-+MCR 
ENTER NAME OF TASK NOT TO TRACE CSI$ DCL...» 
ENTER NAME OF TASK NOT TO TRACE CS]; ..DCL 
ENTER NAME OF TASK NOT TO TRACE CS1%. ..HEL 
ENTER NAME OF TASK NOT TO TRACE CS3% ...BYE 
ENTER NAME OF TASK NOT TO TRACE CS7% ...MOU 
ENTER NAME OF TASK NOT TO TRACE CSI]: ...DMO 
ENTER NAME OF TASK NOT TO TRACE CS]3 «AT. 
ENTER NAME OF TASK NOT TO TRACE CSI: - 


Select parameter catedorys tyre <esc> for help 


ENTER PARAMETER CATEGORY CS1J° ‘nevIce 
DO YOU WANT TO COLLECT DATA FOR ALL DEVICES? CY/NION 


Select device tyres to be traced 
TRACE DISK (DIRECTORY DEVICE) I/0 ACTIVITY? CY/NISY 
TRACE TAPE (SEQUENTIAL DEVICE) I/0 ACTIVITY? CY/NIIN 
TRACE TERMINAL I/0 ACTIVITY? CY/NIIN 
TRACE ALL OTHER DEVICES I/0 ACTIVITY? CY/NISY 
Select rarameter category, type <ese> for help 
ENTER PARAMETER CATEGORY [CS]: MODE 
Tlefine data collection modes tyre <esc> for help 
ENTER MODE CDiMANUALI] CS R20.-8.]% 
LEGAL MODES ARE? 

MANUAL AUTOSTOP REPEAT 


ENTER MODE CD?MANUAL] CS Ri0.-8.]3 REPEAT 
ENTER SAMPLE TYPE CS Ri0-6]3. 


LEGAL SAMPLE TYPES ARE? 

BUFFER TIME 
ENTER SAMPLE TYPE CS R:0-46]! BUFFER 
ENTER NUMBER OF BUFFERS PER SAMPLE CD Ri21.-32000. 0216.12 7400 
ENTER MAX. NUMBER OF SAMPLES CD R21.-32000. D&1.]3.-25 
ENTER INTERVAL BETWEEN SAMPLES TIME UNIT CD&MIN] CS R:0-31]?. 
ENTER INTERVAL BETWEEN SAMPLES IN MIN CD R21.-10000. D81.,33°45 
Select rarameter catedory, tyre <esc> for help 
ENTER FARAMETER CATEGORY CS]: SYSTEM 


Select sustem metrics 


DO YOU WANT THE SYSTEM-WIDE METRICS? CY/NI?Y 
ENTER SYSTEM METRICS SAMPLING INTERVAL (SECS) CD Ri15.-28800. D?60.1% 300. 


Select Parameter category, ture <esce> for help 

ENTER PARAMETER CATEGORY CS]! LABEL 

Define 1 to 63 character label strings type <esce> for hele 
ENTER MPB LABEL CS R30-63]! This is a sample SMPGEN. 


Select rarameter catedory, type <esc> for help 
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ue 


ENTER 


wow 


Write 
Enter 


ENTER 
ENTER 


nee Ww 
Be RE wer we we ce OG 


wo 


PARAMETER CATEGORY CS]! DONE 


seved answer file and parameter source file 
<ese> if no output Pile is desired 


NAME OF SAVED ANSWER FILE CDS TRACE.CMD] CS13- SAMPLE.CMD 
NAME OF PARAMETER SOURCE FILE CDi TRACE.PARJ CSI$ SAMPLE.PAR 


>MAC SAMPLE=HKMAC>s SAMPLE.PAR 
>TKB @PARBLO 
SPIP SAMPLE.OBRJ$*/DE»PARBLD.CMD#X 


?@ <EOF> 


ea 
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EXAMPLE INSTALLATION 


BACKUP RESTORE UTILITY VOi 


>tim O6.19 12/9/81 

?run conf 

> : 
ENTER INPUT DEVICE C/CSR*NNN/VECZNNNI. mm. 

ENTER OUTPUT DEVICE C/CSR=NNN/VEC=NNNI: dre /vec=254 


erun Fmt 
> 


FMT>ar: 

*## WARNING - DATA WILL BE LOST ON DRO: ## 
CONTINUE? CY OR NJ: y 

START FORMATTING 

OPERATION COFPLETE 

FMT>*Z 

run bad 

> 

BAD>dri/li 


BAD -~ DRO: BAD BLOCK FOUND ~ LBN= 24863. 


BAD -- DRO: TOTAL BAD BLOCKS= 1. 
BAD>*Z 
run bru 


> 

BRU>/bacidreys/ve 

FROM: mms 

TO: dre ; 
BRU STARTING TAPE 1 ON MMO: 


BRU 


END OF TAPE 1 ON MMO: 


BRU STARTING VERIFY PASS TAPE 1 ON MNO; 


BRU 


' 


END OF TAPE i ON MMO: 


BRU 


COMPLETED 


BRU O*Z 


RSK-LIM-PLUS VO1 BLE LZ4k 
PRED DRi=SY: 
PRED DR:=LB: 
PRED DR:=SP-: 
>MOU DRORSXILIMPBLE 
>@DLZ,S54]BASTART.CMD 
> 
>? RSX-LIM-PLUS Distriodution kit installation Phase-z 


ad 
“ 


The system disk now contains oniy a bootable baseline system. The 


>? remainder of the distribution Kit must be ioaded From the 

>$ distribution tare by BRU (the BACKUP and RESTORE utility). These 
>} instructions will suide you throush the remainder of the 

>; installation process. 

2F 

>? 1) It is important to specify the correct date and time. Use the 
oF format of “DD-MMM-YY HH:IMM". 

F : 
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se Please enter the date and time (S51: 9-dec-81 8:35 

STINE 9-dee-Bi 8:35 

Pr 

+} Z) Now allocate checkpoint seace for use by system utilites. 
>? 


PACS S¥2/BLKS=1024. 


>? 3) We will now bring oniine all devices which were SYSGEN-ed into 
Pe this baseline image and which exist in your hardware system. 
er 

Pr If there is hardware in your system occupying a control 

2? resister address which conflicts with a standard DEC resister 
D7 assisnments, it is possible that the "CON ONLINE ALL“ command 
?? might cause a system crash. This is because a DIGITAL device 
23 Griver is attemptina to manirulate foreign hardware or 

cae the CSR address assignments in yvour system are different 

?3 from those assumed in this baseline configuration. On 

> the first pass throusn this File please answer "NO<CR>" 

a to the foilowing auestion. If such @ mismatch exists and 

?r a crasn does occur, reboot and answer “YES<CR>" to this 

D>? question. Instructions wiil be provided to hele 

>* circumvent the eroblem. 


oa) 
wae 


>* Do you need to do manuai configuration? CFY/NIiin 


2? 

>CON ONLINE ALL 

DF 

>: 4) We will now create directory entries for the Files to be loaded 

DF from the common backup set. The UFD commands will not be displayed. 


we 
?r 
oe. 


>? 3) Please suprpiy the iosicai name of the magnetic tare drive 


pe which should stiii contain the distribution tare. The 
or name is of the form: ; 

ca 

oP HNO: or 

7 MTZ. etGeoe 

ae 

>e What is the device name of the distribution tape [SJ]: “2 
>@ <EOF> 


bins bru 
>mou mas/For/dens=800 


>bru /noinit/sup/dens:800 mm. dr: 
BRU - STARTING TAPE 1 ON MMO; 


BRU - END OF TAPE 1 GN HG: 


BRU - COMPLETED 


2dmo mms 
DMO -- TTo: DISHGUNTED FROM MMO: oe FINAL DISMOUNT +*## 
98.39223 oee MMO? -- DISMOUNT COMPLETE 
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2@0Z2,S4]bastart 
oF 
hae RSX-LIM-PLUS Distribution Kit installation Phase~2 


>! The eystem disk now contains oniy a beotable baseline system. The 

>? remainder of the distribution kit must be loaded from the 

>; distribution tare by BRU (the BACKUP and RESTORE utility). These 
> instructions wiil @uide you through the remainder of the 

>; installation Process. ; 


> 
>; 4) It is important to specify the correct date and time. Use the 
DF format of "DD-MMM-YY HHOMM". 


>* Please enter the date and time [SJ]: O09-dec-81 08:42 
oTIME 99-dec-81 06°42 
2F 


>: 2) Now allocate checkpoint space for use by system utilites. 


oF 
PACS SY: /BLKS=1024, 
ACS -- CHECKPOINT FILE ALREADY IN USE ON DEVICE 


oy 
>: 3) We wiil now brings online all devices which were SYSGEN-ed into 
oF this baseline imase and which exist in your hardware system. 
oy 
of If tnere ig hardware in your system occupying a control 
DF resister address which conflicts with a standard DEC resister 
ea assignments, it is possible that the "CON ONLINE ALL" command 
>; misht cause a system crash. This is because a DIGITAL device 
>? driver ig attempting to maniPulate foreign hardware or 
4 the CSR address assignments in your system are different 
pad from those assumed in this baseline configuration. On 
or the first pass throush this file please answer "NO<CR>" 
Bad to the following auestion. If such a mismatch exists and 
par a crash does occur, reboot and answer “YES<CR>" to this 
>? question. Instructions will be provided to hele 
2? circumvent the problem. 
>t 
>» Do you need to do manuai confisuration? CY/Niin 
>? 
>CON ONLINE ALL 
>: 
>? S$) Please surppiy the leosical name of the masnetic tare drive 
>? which ¢hould still contain the distribution tare. The 
Par name is of the form. 
oe MMO; or 
oF MTZ: etc... 
PF 
>* What is the device name of the distribution tarpe [S]2 mm: 


oe Is mms written at 1600 BPI? CY/NIen 


2; 6? We will now mount that tare for access by BRU. 
aes 

2MOU mm: /FOR/DENS=800 

>? 

>: 7) Ensure that the BRU task is installed. 

D7 ' 

DF 

>? &) We wiil now load the remainder of the distribution kit. 
5 

>TIME 

08243°22 99-BDEC-81 

>BRU /REW/DENS:800/BAC:COMMON/NOI em: SY: 

BRU - STARTING TAPE | ON MPO: 
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BRU - END OF TAPE 1 ON MMO: 


BRU - MGUNT TAPE 2 ON MMO: 


NI 


BRU - MOUNT TAPE 2 ON HHO! 
BRU - STARTING TAPE 2 ON MNO: 
BRil - END GF TAPE Z ON MMO: 


BRU -—- COMPLETED 


STIKE 

99204552 o9-DEC-Bi 

>DMO mm: 

DHO -- TTo: DISMOUNTED FROM MMO: wee FINAL DISMOUNT #4 


O904i53 *##2 MMO? -- DISMOUNT COMPLETE 

2? &) The instailation of the RSX-11M-PLUS kit is now compiete. The next 
>? time this disk is booted, this command dialogs wiil not be rereat 
>? We will now proceed through the normal etartup command sequence. 


PSET /UIC#(2,84) 
2INS #PIP/INC=16000 


.ePIP [200,20015YSGEN.CMD/RE/NV=SYSGEN.CMD 


oPIP LBSCi;LIKITIDENT.DAT/AP=LB: LZ,54]INSTALOG.DAT 


T /UIC=C200,200] 
PLEASE NOTE 


yOu have not ve. read the system reieage notes do ¢0 now before 
attempting to perform a SYSGEN or utilize the new features of 
thie svetem. 


SE A tat wt ae 
mt 
wh 


wee vere ee DD ve 
ial 


ee! 


2CON GNLINE ALL 

SRUN ERRLOG 

ERL -- ERROR LOG INITIALIZED 
*START/ QUEVUE/ MANAGER 


PINS $GNGPRT/TASK=PRT.../SLVENG 

OGI657353 GHG -- UNEXPECTED EXIT PROCESSOR LPPO 
DINITIALIZE/QUEUE LPQO 

O98 205535 QMG -- UNEXPECTED EXIT PROCESSOR BAPO 
INI -- QUEUE ALREADY EXISTS 

DINITIALIZE/ PROCESSOR LPPO/FLAG:2/FORM:0/LOWER 
INI -- DEVICE GFFLINE 

DINITIALIZE/PROCESSOR BAPS 

INI -—-#WARNING#-- ACCOUNTING NOT ACTIVE OR NOT INSTALLED 
PASSIGN/GUEUE PRINT LPPO 

€&SS ~-- PROCESSOR DOES NOT EXIST 

>ASSIGN/QUEUE BATCH BAPO 

7@ <EOF> 

2@L200,200]syssen 

>? RSX-11M-PLUS SYSGEN BLE& 

>? 

>, COPYRIGHT (C) 1979, 1980 

>; DIGITAL EQUIPMENT CORP.» MAYNARD MA., 01754 
>F 

>SET /UIC=£200,200]7 

>TIM 

09$:°068:39 O9-DEC-B8i 


>? EXPANDED COMMENTS PROVIDE A DESCRIPTION OF EVERY STEP_IN THIS 


EXAMPLE INSTALLATION 


ed. 


H-4 


>) SYSGEN COMMAND FILE. ON THE OTHER HAND, SHORT COMMENTS 
2+ PROVIDE VIRTUALLY NO EXPLANATORY TEXT. 


2INS LBIC3,S34IMACBIG/INC=20000 

2INS LB: C3, S54ILBR/INC=20000 

DINS LB:03-S4]7TKBBIG/INC=20000 

?INS LBIC3,S4]EDI 

SINS LB.£3,54]UMR 

2INS LBLC3,54IFLX/INC#20000 

>* DO YOU WANT EXPANDED COMMENTS? CY/NIin 

>* ENTER DEVICE.LUNIT OF RELEASE DISK CDDU:] CS R:2-33: dr: 
SASN driezIne 

PASN drisQUe 

2ASN dri=Sy: 

SASN drselBe 

DASN drosWkK: 

PASN dri=TKe 

ASN dri=BC: 

%ASN drsaltc 

oASN dri =0Bs 

DASN dri=EXs 

DASN dri=MPe 

># DO YOU WANT TO APPLY AUTOPATCH ( <ESC> FOR DETAILS )? CY/Niiy 


?; ENTER THE DEVICELUNIT OF THE DRIVE ON WHICH THE AUTOPATCH TAPE 
7 KIT 1S LOADED OR "“SYi" IF THE AUTOPATCH KIT HAS ALREADY 

7 BEEN READ FROM THE DISTRIBUTION MEDIA. 

>* AUTOPATCH KIT DEVICE CSI: mm: 

°SET /UIC#Ci,11] 

DF 

>? THE PREVIOUS CONTENTS OF THE AUTOPATCH WORK DIRECTORY ARE NOW PURGED 


>PIP LBSCisiije.#7*/DE/NA 
>; READ THE AUTOPATCH COMMAND FILE FROM THE AUTOPATCH TAPE 


>* IS ma: WRITTEN AT 1600 BPI? CY/NIin 

>MOU mms /FOR/DENS=800 

>BRU/REW/NOINIT/BAC: AUTOPATCH/DENS:800 mm: SY! 
BRU ~ STARTING TAPE 1 ON MMO: 


BRU - END OF TAPE 1 ON MMO: 
BRU ~ COMPLETED 


YSET /UIC=C250, 2603 

PIP £200,200]/NV=C1,41 JAUTOPATCH.CMD 
> 

>; Autorpatch 1€ OCTOBER, i981 

>? 


>; Create the FORTRAN interface Routine 
>r obJect File UFD 


>UFD dri£32.203 

> Create the SYSLIB obJect File UFD 

SuFD dri{33,203 

> Copy the updated Files to dr: 

>BRU /REWIND/NOINIT/SUPERSEDE/BAC: UPDATES mm: dr? 
BRU - STARTING TAPE 1 ON MMO: 


12/81 EXAMPLE INSTALLATION 


12/81 


BRU - END OF TAPE 1 ON MMO: 
BRU ~— COMPLETED 


*SET /UIC=C1i,1] 

> 

>! Insert the updated file system object files into SYSLIB 
>? 

>PIP FCS.OBS/NV2£50,20]*.0BJ 

>LBR SYSLIB/RP=FCS.OBS 

MODULE "CONTRL" REPLACED 


MODULE “PNTMRK" REPLACED 

>PIP FCS.O0BS70/DE 

33 Insert the updated FORTRAN Interface Routine obJect files into SYSLIB 
SPIP FIR.OBS/NV=(52,201%.0BJ 

>LBR SYSLIB/RP=FIR.OBS 

MODULE ".CNMRK" REPLACED 

MODULE ".DSCKP" REPLACED 

MODULE ".ENAST" REPLACED 

MODULE ".ENCKP" REPLACED 

MODULE ".INAST" REPLACED 

MODULE "SPSUB " REPLACED 

MODULE “.WFLOR" REPLACED 

>PIP FIR.OBS;0/DE 

3} Insert the updated SYSLIB obJject files into SYSLIB 
oe SLB.OBS/NV=C£55,201]*.0BJ 


>LBR SYSLIB/RP=SLB.OBS 
MODULE "OVCTR " REPLACED 


MODULE “$SUPL " REPLACED 
MODULE "$SUPL " REPLACED 


>PIP SLB.OBS;0/DE 


LBR SYSLIB/RP=QIOSYM.OBJ/SS 


MODULE “QIOSYM" REPLACED 


>? 

>! Insert the updated macro files in RSXMAC.SML 
>? 

>LBR RSXMAC.SML/RP=MACRO.MCS 

MODULE "SCAL$S" REPLACED 


MODULE “VSDAS “ REPLACED : 


>PIP MACRO.MCS:+#/DE 

># DO YOU WISH TO COPY THE CORRECTION AND PATCH FILES TO dre? CY/Nisy 
>: 
>? Create any necessary UFDs 
fF 

>UFD drif24,60] 


EXAMPLE INSTALLATION H-6 


12/81 


“DUFD drt032,60) 


2UFD dri 33,60] 
2UFD drif34,60) 
2UFD dril36,80] 
>UFD dri f45,60] 
2UFD dri£32,60] 
>UFD dri f62,60] 
2UFD drit70,60] 
2UFD drifi06,60] 
SUFD drofi17,60) 
SUFD dri £200,680] 


>? Copy the correction and patch Files to dr? 


BRU /REW/NOINIT/NEW.VERSION/BAC: CORRECTIONS mas drs 


BRU - STARTING TAPE 1 ON MMO; 
BRU - END OF TAPE 1 ON MMO: 
BRU - COMPLETED 


>* DO YOU WISH TO PAUSE TO COPY OR EDIT ANY CORRECTION FILES? CY/Niin 
+ 
7 APPLICATION OF THE AUTOPATCH IS COMPLETE. A RECORD OF THIS 
>; WILL BE APPENDED TO THE KITIDENT FILE. 
DF 
2SET /UIC=C1,11 


>DMO mms 
DMO -- TTO: DISMOUNTED FROM MMO: “ee FINAL DISMOUNT *## 
OS:21:50 ### MMO? -- DISMOUNT COMPLETE 


2SET /UIC=£200,200] 

>* DO YOU WANT TO DO SYSGEN PART 1 (ASSEMBLE THE EXEC)? CY/Niin 

>* DO YOU WANT TO DO SYSGEN PART 2 (BUILD THE EXEC AND PRIV TASKS)? LY/NIin 
>* DO YOU WANT TO DO SYSGEN PART 3 (BUILD UTILITY TASKS)? LY/Niin 

2ASN = 

>@ <EOF> 

> 


oufd drifi2,2]) 
>set f/uies#fli2,2]) 


>mou macs/for 

1x /r¢2@m: Pmoncey.cad/do 

> 

>@rmoncey. 

>* IS SOURCE DEVICE A MAGTAPE? LY/Nily 

>* IS DESTINATION DEVICE A MAGTAPE? CY/N]: 

>* ENTER SOURCE DEVICE (DDN!) CS]: mm: 

>* ENTER DESTINATION DEVICE (DDN2) CS]: dr? 

>* IS dr: MOUNTED? CY/Niiy 

>? 

>? PLEASE SPECIFY THE GROUP AND MEMBER NUMBERS OF THE SOURCE KIT DIRECTORY. 
>? THE ORIGINAL KIT DISTRIBUTION IS IN DIRECTORY (12,21. 

> 

># ENTER GROUP NUMBER OF SOURCE KIT DIRECTORY (CO R°1-377 Di1i23°: 

.7 ENTER MEMBER NUMBER OF SOURCE KIT DIRECTORY CO R!1-377 Di23° 

>? PLEASE SPECIFY THE GROUP AND MEMBER NUMBERS OF THE DIRECTORY To WHICH 


>* THE SPM-11M-PLUS KIT FILES WILL BE COPIED. 
>3 


EXAMPLE INSTALLATION H-7 


12/34 


>* ENTER GROUP NUMBER OF TARGET DIRECTORY CO Ri1-377]3. 12 
2* ENTER MEMBER NUMBER OF TARGET DIRECTORY £0 R:21-3771]: 2 


>SET 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
>FLX 
pFLX 
>FLX 


/UIC#Ci2,2] 

dri /RS=mam.CiZ,ZISMPGEN.CMD,SPM.DOC/DO 

dri /RS/-RW=mm.012,27HKMAC.MAC, PMONSLP.CMD/DO/-RW 

drs /RS/-RW=mm.012,27]SGNPER.COR,DRCRV.COR/DO/-RW 

dr: /RS/-RW=mm.012,2]DRDSP.COR, DREIF.COR,DREXP.COR/DO/-RW 
dri /RS/-RW=mm.012,Z]DRGIN.COR,DRGIO.COR, DRTBL.COR/DO/-RW 
dri /RS/-RW=mm.012-Z]LOWCR.COR,SYSCM.COR/DO/—RW 

dr: /RS/-RWeam.012,Z2]REQSB.COR,LOADR.COR/DO/-RW 

dri /RS/-RWemm2012,Z2]10SUB.COR,SYSXT.COR, TDSCH.COR/DO/-RW 
dri /RS/-RWemms,012:Z2]PMONPAT.CMD-DISPAT.PAT/DO/-RW 

dri /RS/-RW=mm.012,21COL.OLB,COLBLD.ODL» PMONBLD.CMD/DO/-RW 
dr: /CO/RS/BL°60./-RWemm.012,2I]CLF.TSK/DO/-RW 

dr: /CO/RS/BL.73./-RWemm:012,Z2]0VL.TSK/DO/-RW 

dr: /CO/RS/BL.175./-RW=mm2012,2IDRS.TSK/DO/-RW 

drs /RS/-RW=mm2012>21]0VL.MAP,OVL.OLB/DO/-RW 

dro /RS/-RWamms01i2,Z21CLF.MAP,DRS.CMD,MDRTKB.CMD/DO/-RW 
dri /RS/-RW=mm2012,Z21MDREIS.OLB,MDRFPP.OLB,DRS.MAP/DO/-RW 


>% APPLY CORRECTIONS TO EXECUTIVE SOURCES? CY/Ni:y 


> INS 
>SET 
>PIP 
PSLP 
>SET 
>SLP 
>SLP 
>SLP 


.>SLP 


>SLP 
>SLP 
>SLP 
>SLP 
>SLP 
>SLP 
>SLP 
>SLP 
>SLP 
>SLP 
>REM 
7 
>? 
>? 
>? 
> 


$SLP 
/UIC=£200,200] 
RSXMCO.MAC/AP=C1Z2+Z]HKMAC.MAC 
@C12,Z21]SGNPER.COR 
/UIC=C11,10] 
@C12,2]DRCRYV.COR 
@f£12,2]DRDSP.COR 
@C12,2]REQGSB.COR 
@C1i2,Z2Z1SYSXT.COR 
@C12,ZIDREIF.COR 
@C12,2IJDREXP.COR 
@CiZ,ZIJLOADR.COR 
@C£12,2]DRG10.COR 
@f12,21]I0SUB.COR 
@Ci2,231SYSCM.COR 
@£12,2]LOWCR.COR 
@£12,2]DRTBL.COR 
@CiZ2,2IDRGIN.COR 
@C12,2]TDSCH.COR 
oa oSLP 

e#- NOTE ~## 


DO NOT APPLY THE FOLLOWING PATCH TO FiilACP IF YOU ARE GOING 
TO SELECT THE FCPROG (DEFAULT) FiiACP AT SYSGEN. 


># APPLY PATCH TO F11ACP DISPATCHER MODULE (DISPAT)? CY/NIicy 


>INS 


SPAT 


>SET /UIC=C12-2] 


MAC 
>LBR 


DISPAT.POB=HKMAC .MAC,»DISPAT.PAT 
DISPAT.OBJ;1=C1i,241FCP/EX: DISPAT 


>PAT DISPAT.OBJ:2Z2=DISPAT.OBJ:1/CS°044214,DISPAT.POB/CS.017664 
>* WAS THE CHECKSUM SUCCESSFUL? CY/Ni:y 


2SET /UIC=C1-24] 
>LBR FCP/RP=C12,21DISPAT.OBJ;2 
MODULE "DISPAT" REPLACED 


>REM ..0PAT 
2SET /UIC=£12Z,2) 


>8 <EOF> 

+dmo mm: 

DMO -- TTO: DISMOUNTED FROM MMO: eee FINAL DISMOUNT ### 
09:41:19 #“##% MMO: -- DISMOUNT COMPLETE 


> 


EXAMPLE INSTALLATION 


12/81 


>set /uic=£200,200] 
>@sysgen 


>F 
a: 
>? 
>? 
de 


RSX-11M-PLUS SYSGEN 6L6 


COPYRIGHT (C) 1979+ 1980 
DIGITAL EQUIPMENT CORP.» MAYNARD MA.» O1754 


oSET /UIC=£200,200] 
>TIM 


og: 


>F 
oF 
>? 
>F 
>F 
Pod 
>* 


42.23 O8-DEC~@i 


EXPANDED COMMENTS PROVIDE A DESCRIPTION OF EVERY STEP IN THIS 
SYSGEN COMMAND FILE. ON THE OTHER HAND, SHORT COMMENTS 
PROVIDE VIRTUALLY NO EXPLANATORY TEXT. 


BO YOU WANT EXPANDED COMMENTS? CY/Niin 
ENTER DEVICE_UNIT OF RELEASE DISK CDDU:] CS R:2-5]: dr: 


SASN drseINe 
>ASN dre=OU: 
SAGN dre=SY: 
2ASN dreeLBs 
SASN droeWK 
2ASN dreeTKs 
2ASN drssBC: 
PASN dreeLi: 
2ASN drez=0B: 
>ASN drieEX: 
2ASN droeMPs 


> 
>e 
or 
> 
PF 
oF 
>F 
>& 


DO YOU WANT TO APPLY AUTOPATCH ¢ <ESC> FOR DETAILS )? CY/NItn 
DO YOU WANT TO DO SYSGEN PART 1 (ASSEMBLE THE EXEC)? CY/Nicy 


REX-11IM-PLUS SYSGEN PART 1 <VERSION 1.0> 
DETERMINE SYSTEM FEATURES AND ASSEMBLE THE EXECUTIVE 


HAVE YOU ALREADY RUN SGN? CY/NIen 


2SET /UIC=fi1,+24) 

oPIP IND #. OBJ; #/DE/NM;*. TTY; #,%.OBS;% 
2SET /ULC=C1-24) 

OPIP INCC11,10I]RSXMC.MAC: */DE/NM,SYSTB;# 
>PIP INS C11,24]RSXASM.CMD;#/DE/NM 


>PIP 


>PIP INCCi,Z24]DIRI1M.CMD;>#/DE/NM»DIRCOM.CMD;>#,DIR.CMD;* 
>8ET /UIC=£200,200] 
2PIP RSXMC.SAV/PU/NM,» SGNSYM.CMD 


oF 
oF 
>F 
>? 
>e 
oF 
>F 
>> 
DF 
>? 
>? 
oe 
DF 
oF 
oF 
oF 
> 
>? 


START SGN -- VERSION 06.008 


BEGIN PART A OF SYSGEN PHASE 1 


EXPANDED COMMENTS RESULT IN THE DISPLAY OF EXPLANATORY TEXT 
PRECEDING EACH QUERY. SHORT COMMENTS OMIT THE TEXT. EXPANDED 
COMMENTS ARE AVAILABLE ON A PER QUERY BASIS BY ENTERING ESCAPE 
OR ALTMODE FOLLOWING THE DISPLAY OF THE QUERY. FOR QUESTIONS 
THAT CONTAIN A RANGE SPECIFICATION, AN ANSWER THAT FALLS 
WITHIN THE RANGE MUST PRECEDE THE ESCAPE. THIS ANSWER WILL 
HAVE NO EFFECT ON THE QUESTION WHEN IT IS ASKED AGAIN. 


TO EXIT FROM THE SGN INDIRECT FILES AT ANY TIME, TYPE CNTRL/Z. 


IF YOU ARE UNSURE OF THE ANSWER TO A QUESTION FOR WHICH A DE- 
FAULT ANSWER EXISTS, USE THE DEFAULT ANSWER. 


EXAMPLE INSTALLATION 


INS C1,24]R8XBLD.CMD;#/DE/NM,;DSP1i1M.CMD>*,-LDRI1M.CMD;#,»RSX11M.CMD;:+% 


H-9 


12/81 


LONG DIALOGUE DESIRED FOR EXECUTIVE/PROCESSOR OPTIONS? CY/NIin 
DO YOU WANT THE STANDARD FULL-FUNCTIONALITY EXECUTIVE? CY/Nisy 
ASSEMBLY LISTING FILES DESIRED? [EY/Nicy 

WHAT IS TO BE THE LISTING DEVICE? CpoDU:] ES Ri2-5]): dr: 

SPOOL LISTING FILES? CY/Niin 


THE TASK BUILDER MAP OF THE EXECUTIVE WILL BE SAVED ON THE SYSTEM DISK. 
BEGIN EXECUTIVE SERVICE OPTIONS. 

DO YOU WANT DECNET SUPPORT? CY/NI:n 

ARE YOU PLANNING TO INCLUDE A USER WRITTEN DRIVER? CY/NIin 

DO YOU WANT TO INCLUDE THE EXECUTIVE DEBUGGING TOOL. (XDT)? CY/Nicy 

ENTER CRASH NOTIFICATION DEVICE CSR ADDRESS [£0 R:160000-177700 D21775641. 


ON WHAT DEVICE DO YOU WISH CRASH DUMPS TO BE WRITTEN CDD1 €S R:2-31: mm: 
WHAT IS THE PHYSICAL UNIT NUMBER OF THE CRASH UNIT [CO R:0-7 Diol: 0 


END EXECUTIVE SERVICE OPTIONS. 
BEGIN PROCESSOR OPTIONS. 
ENTER MEMORY SIZE (1024 WORD BLOCKS) CD R:128.-1920. BD:256.4]: 320 
DO YOU WANT FLOATING POINT PROCESSOR SUPPORT? [Y/NIiy¥ 
IS YOUR SYSTEM CLOCK PROGRAMMABLE (KW11-P)? CY/NIin 
IS YOUR LINE FREQUENCY 30 HERTZ? CY/NIcn 
END PROCESSOR OPTIONS. 
END PART A OF SYSGEN PHASE 1 
DO YOU WANT TO CONTINUE WITH PART B OF THIS SGN? CY/NIcy 


WE WILL NOW CONTINUE WITH PART B OF SYSGEN PHASE 1 


BEGIN PERIPHERAL OPTIONS. 


EXPANDED COMMENTS DESIRED FOR PERIPHERAL OPTIONS? LY/NIin 
HOW MANY RH CONTROLLERS DO YOU HAVE [O R:0-17 D4]: 2 


HOW MANY RPO4/05/06 DISK PACK DRIVE UNITS DO YOU HAVE? £0 R:50-77]. 0 


HOW MANY RMO2/03/05 DISK DRIVE UNITS DO YOU HAVE? [O R:0-77]: 2 
ARE ANY OF THE UNITS DUAL-ACCESS? CY/NI en 


WHAT IS THE PHYSICAL UNIT NUMBER OF DRO: [0 R:0-7 DO]: 0 
TO WHICH RH CONTROLLER IS DRO: CONNECTED (SJ: A 
ENTER THE DISK TYPE FOR DRO: (RMOZ»RMO3,RMOS) CSI]° rmo03 


WHAT IS THE PHYSICAL UNIT NUMBER OF DRI: CO R:0-7 Deil: 
TO WHICH RH CONTROLLER IS DRi: CONNECTED [CS]: A 
ENTER THE DISK TYPE FOR DRI: (RMOZ,;RMO3,RMOS) CS]:2 rmo\o\03 


HOW MANY R&O3/04 DISK DRIVE UNITS DO YOU HAVE? (0 RI0-771. 0 


HOW MANY TU16/45/77/TE16 TAPE UNITS DO YOU HAVE? [0 R20-100]: 1 
HOW MANY MASTER DRIVE UNITS ARE THERE (Ol: 1 


WHAT IS THE PHYSICAL UNIT NUMBER OF MMO: CO R:0-7 D:O1. 
TO WHICH RH CONTROLLER IS MMO: CONNECTED (S1]: 8 


THE AVAILABLE SLAVE UNITS HAVE ALREADY BEEN ALLOCATED TO OTHER 


MASTER DRIVES. MASTER DRIVE MMO! IS THEREFORE ASSUMED TO HAVE 
NO SLAVE DRIVE UNITS ATTACHED TO IT. 


EXAMPLE INSTALLATION H-10 


L27s1 


ee 


De 
+e 
> 
> 
> 
> 
pat 
>e 
>e 
+e 
> 
Sat 
> 
3 
> 
>a 
> 
> 
>% 
> 
>a 
>a 
> 
Sat 
># 
>a 
># 
>? 
>* 
>e 
Se 


oe 


+ 
># 
> 
># 
oe 
># 
ss 
xs 


‘ENTER THE VECTOR ADDRESS OF RHA CO RiG0-774 D254]: 


WHAT IS ITS CSR ADDRESS CO R:2160000-177700 D:1767001: 

ENTER THE VECTOR ADDRESS OF RHB CO R:60-774 D:224]: 

WHAT IS IVS CSR ADDRESS [(O R2160000-177700 D:1724401: 

HOW MANY RKil CARTRIDGE DISK CONTROLLERS DO YOU HAVE? [CO]: 0 

HOW MANY RKG11 DISK CARTRIDGE CONTROLLERS DO YOU HAVE? [0]: 0 

HON MANY RP11-C/E DISK PACK CONTROLLERS DO YOU HAVE? CO]: 0 

HOW MANY CM/CRii CARD READERS DO YOU HAVE? [OI]: 0 

HOW MANY TALL DUAL CASSETTES DO YOU HAVE? [0]: 0 

HOW MANY RL1i1 DISK CARTRIDGE CONTROLLERS DO YOU HAVE? [QO]: 0 

HOW MANY TSii MAGTAPE CONTROLLERS DO YOU HAVE? [O01]: 0 

HOW MANY TC11 DECTAPE CONTROLLERS DO YOU HAVE? [COI]: 0 

HOW MANY RXii DISK CONTROLLERS DO YOU HAVE? CO]: 0 

HOK MANY RXZ11 DISK CONTROLLERS DO YOU HAVE? COI: Oo. 

HOW MANY TUS8 CONTROLLERS DO YOU HAVE? [CO]: 0 

HOW MANY LP/LS/LV11/LA180 LINE PRINTERS DO YOU HAVE? [CO]: 0 

HOW MANY TM/TMA/TMB11 MAGTAPE CONTROLLERS DO YOU HAVE [0]: 0 

HOW MANY PCil PAPER TAPE READER/PUNCHES DO YOU HAVE? [O]: 0 

HOW MANY PRiil PAPER TAPE READERS DO YOU HAVE? CO]: Q 

HOW MANY LPAIi-K LAB SUBSYSTEMS DO YOU HAVE? [CD R:0.-16.]: 0 

HOW MANY IP113 INDUSTRIAL CONTROL SUBSYSTEMS DO YOU HAVE? CO]: 0 
ENTER NUMBER OF ADDITIONAL DLil LINE INTERFACES CO R:0-10 D0]: 0 
ENTER TERMINAL TYPE FOR YLA (DEFAULT= LA3SG) [CS]: - 

ENTER NUMBER OF DH1ii1 ASYNCHRONOUS LINE MULTIPLEXERS [CO R20-20]: 0 
ENTER NUMBER OF DJii ASYNCHRONOUS LINE MULTIPLEXERS £0 R:0-20]: 06 
ENTER NUMBER OF DZ1i ASYNCHRONOUS MULTIPLEXERS [0 R:0-401: 2 

DO ANY OF THE LINES REGUIRE MODEM SUPPORT? CY/NI: 

AT WHICH BAUD RATE DO YOU WANT TO ANSWER? CSI: 300 


ENTER VECTOR ADDRESS OF YZA [0 R:2300-7741: 300 

WHAT IS ITS CSR ADDRESS? [0 R:160000-1777001: 160070 
HOW MANY LINES DOES IT HAVE? [D R21.-8. D:8.1: 

ENTER TERMINAL TYPE FOR YZA (DEFAULT= VT52) CS]: V¥T100 


ENTER VECTOR ADDRESS OF YZB [0 R:300-7741: 310 

WHAT IS ITS CSR ADDRESS? CO R:160000-1777001]: 160100 

HOW MANY LINES DOES IT HAVE? CD Ri1.-8. Di8.1: 

ENTER TERMINAL TYPE FOR YZB (DEFAULT= VT52) £8]: VT100 

DO YOU HAVE ANY INTER-COMPUTER COMMUNICATION DEVICES? CY/NIin 


END PERIPHERAL GPTIONS. 


»PIP RSXNC.MAC=RSXMC.SAV,RSXMC. TMP ,RSXMCO.MAC . 
2PIP RSXMC. TMP? #/DE 

oSET /UIC=f1,54] 

>PIP €1,S4]/RE/NV=£200, 200] UMRTTY CMD 

?SET /UIC=C1,24] 

2PIP Cii,10]/RE=£200,200]RSXMC.MAC;#,SYSTB.MAC; * 

>PIP €11,24]/RE=€200,200I1RSXASM.CMD 

oPIP €1,243/RE/NM=[200, 200 ]RSXBLD.CMD,;RSX11M.CMD,»DSP11M.CMD,LDR11M.CMD 
>PIP £1,241] /RE=C£2Z00,2001]DIR11M.CMD,DIRCOM.CMD,DIR.CMD 


> 


DO YOU NISH TO PAUSE TO EDIT ANY OF THE SGN GUTPUT FILES? CY/N1: 


2SET /UTC#Cil» 24] 
oTIM 
09.55:°22 O8-DEC-@1 


MAC BINS RSXASM 


>TIM 

10:29:54 O09-DEC-61 

>PIP RSX.OBS=*.0BJ 

>PIP RSX11M.0BJ/RE=RSX.OBS 

>PIP TTDRY.OBS=#.TTY 

2SET /UIC=£200,200] 

>PIP OU: /NV=IN-CiLl,1OJRSXMC.MAC 
oSET /UIC=C£1,24] 

>PIP INS RSXBLD.CMD/PU/NM 

>PIP INC RSX11M.0LB;*/DE/NM 


EXAMPLE INSTALLATION H-11 


12/64. 


>PIP £200,200]RSXMC.MAC/PU/NM 
,2LBR IN-SRSXLIM/CR-256.51800.:256.*O0U:011,241RSX11M.0BJ 
SLBR IN: TTDRYV/CR.40.°5392.°5128.=0U:011,241]TTDRV.OBS 


DF 
> 
>? 
>* 
DF 


dy 


> % 


END SYSGEN PHASE 1 
DO YOU WANT TO DO SYSGEN PART 2 (BUILD THE EXEC AND PRIV TASKS)? LY/NIiy 
IF YOU HAVE ALREADY DONE A SYSGEN ON THE TARGET DISK: A 
SYSTEM MAY RESIDE IN €1-54]. YOU MAY WANT TO SAVE THAT 
SYSTEM. 
HAVE YOU DONE A SYSGEN ON THE TARGET DISK BEFORE? CY/Niin 
RSX-LIM-PLUS SYSGEN PART 2 <VERSION 1.0> 
BUILD THE EXECUTIVE AND ALL PRIVILEGED TASKS 


HAVE YOU ALREADY BUILT THE EXEC? CY/NIin 


oSET /UIC#£1,24] 
>TIM 


10: 


33:20 09-DEC-81 


?TKB @RSXBLD 
>TIM 


10: 


> 


35,04 OS-DEC-S81 
DO YOU WANT TO CONTINUE AND BUILD THE TASKS NOW? CY/Nity 


PSET /UICHC1,24] 


> 
> 


WHAT FCP DO YOU WANT (DEFAULT = FCPRO3)? £S1: FCPRO2 
DO YOU NEED TO EDIT ANY OF THE BUILD COMMAND FILES? CY/Niin 


OSET /UIC=C1,34] 
>PIP SYSVMR.CMD=VMRTTY.CMD/AP 


> 
Dy 
>, 


« 
YF 


DO YOU WANT TO EDIT SYSYMR.CMD? CY/NIin 


NOW WE BUILD THE PRIVILEGED TASKS AND LOADABLE DRIVERS 


>ASN NLI=MP: 


> 


DO YOU WANT THE MAPS OF THE PRIVILEGED TASKS? CY/NIin 


29SET /UIC=£200-200] 


>F 

>F 

ea 

>? 
oF 
>F 
>e 
>> 
D5 
Pe 
oy 
or 
>? 
7 
>F 
>? 
>* 


MAPS OF THE DRIVERS WILL BE SAVED ON THE SYSTEM DISK 


IF ANY OF THE DRIVERS YOU ARE BUILDING HAVE A LOADABLE DATA BASE, 
YOU NEED TO EDIT THE FILE DRIVERS.B8LD TO ADD THE NAME OF 
YOUR DATA BASE MODULE AFTER THE NAME OF YOUR DRIVER MODULE. 


FOR EXAMPLE: 


#PL LBOXXDRY 
SY:C1,24IRSX11M/LB.XXDRY 

#AP SXXTAB 
SY.C1,24IRSX11M/LB2XXDRV: XXTAB 
¥ED 


DO YOU NEED TO EDIT DRIVERS.BLD? CY/Nitn 


>SET /UIC=C1,24] 

2TKB @£€200,200]DRIVERS.BLD 

2PIP SYIC1,34]TTCOM. TMP; #/DE/NM 
28ET /UIC#£200,200]) 


> 
?? 
a 
>e 


BLDDRY SAVES THE COMMAND FILE USED TO BUILD THE DRIVER‘(S) 
IN £200,200], AND NAMES IT DRIVERS.BLD 


>TIM 


10 


-39:52 O9-DEC-81 


rea 
BR 


EXAMPLE INSTALLATION H- 


2TKB @ACCBLD 
>TKB @ACNBLD 
?TKE @ACSBLD 
2TKB @BO0BLD 
oTKB @BPRBLD 
>TKB @BROBLD 
>TKB @BYEBLD 
>TKB @COTBLD 
TKB @DCLBLD 
@TKB @DCLDSPBLD 


2TKB @DMOBLD 
->TKB @ERFBLD 


.>TKB @ERLFSLBLD 
‘PTKB @FCPROZBLD 
S>TKB @FXRBLD 
OTKB @FLIMSGBLD 
OTKB @HELFSLBLD 
DTKB @HRCBLD 
>TKB @INDFSLBLD 
W>TKB @INIBLD 
>TKB @INSFSLBLD 
->TKB @LOABLD 
>TKE @LPPBLD 
>TKB @MCRBLD 
>TKB @MCRDSPBLD 
>TKB @MOUBLD 
>TKB @MTABLD 
>TKB @PMDFSLBLD 
>TKB @GMGFSLBELD 
OTKB @RMDBLD 
>TKB @SAVBLD 
>TKB @SHABLD 
>TKB @SHFBLD 
PTKB @SHTBLD 
>TKB @SYLFSLBLD 
DTKB @TKNBLD 
OTKE @UFDBLD 
>TKB @UNLBLD 
>TIM 

1iii162S5i O9-DEC~-a1 
ASN LBI=0U: 
>SET /UIC=C1,543 
ASN LBI=SY: 
>PIP OUIRSXL1M.SYS/CO/NV/BLi498. =INSRSXL1M. TSK 
>VUMR @SYSYMR 


LOADING EXECUTIVE DATA SPACE 
DATA SPACE LOADING COMPLETED 
VNR ~~ INSTALLED TASKS OR COMMONS MAY NO LONGER FIT IN PARTITION 
BET /TOP=FCPPAR. ~# 
UMR ~-- INSTALLED TASKS OR COMMONS MAY NO LONGER FIT IN PARTITION 
SEY /TOP=DRUPAR.-# 
SYSPAR 026320 00202500 00012000 MAIN 
LDRPAR 026254 00214500 00003000 MAIN 
024644 00214500 00003000 TASK C..LDRI 
FCPPAR 026210 00217500 00051500 MAIN 
SECPOL 026040 60271200 00010000 SEC POOL 
DRYPAR 025774 00301200 00074200 MAIN 
025730 00301200 00001400 DRIVER (RD:) 
O2Z5664 00302600 00001300 DRIVER (VT:> 
0235620 00304100 00000100 DRIVER (NL?) 
0235554 00304200 60003100 DRIVER (CO:> 
025510 00307300 00004600 DRIVER (MM?) 
025444 00314100 00004700 DRIVER (DR:) 
625400 60321000 00035400 RW COM ITTCOM | 
625314 00356400 00017000 DRIVER (TT?) 


127 oe EXAMPLE INSTALLATION H-13 


12/81 


GEN 

oe «LDR 
TKTN 
ow RMD 
FiiMsG 
MTAACP 
SHE... 
ee DCL 
DCL... 
ee DMO 
e« MCR 
MCR... 
e+ MOU 
FLIACP 
COT... 
ERRLOG 
HRC. oo 
PMD... 
SYSLOG 


025250 00375400 02002400 MAIN 


08.01 
03.16 
YO.01 
VOOi1 
0010 
01.02 
01138 
O113A 
23.02F 
01.01 


1.068 
01.01 
04.27 
01.01 
04 
01.01 
3 
O1.1 
04.12 
V3A 
01.93 
01.01 
01.25 
03.3 
02.01 
03.4 
OFL 
OFL 
OFL 
OFL 
OFL 
RHAO: 
RHAI: 
RHBO: 


YLAO: 
¥ZAO™ 
¥YZAL; 
YZAZ¢ 
YZA3: 
YZA4a: 
YZAS: 
YZAG: 
YZA7. 
YZBO: 
Y2ZB1- 
Y2ZBa. 
YZB3: 


025060 
113160 
114220 
116110 
1143534 
113600 
116740 
116634 
116530 
115050 
114744 
114640 
026104 
117044 
116320 


‘115700 


114430 
113264 
113474 
116214 
115470 
115364 
114114 
113054 
117464 
114324 
115154 
0243524 
115574 
114010 
116424 
113704 
024420 
117674 


117570. 


117360 
117254 
117150 
116004 
115260 
113370 
112750 
CPA 
CPA 
CPA 
CPA 
CPA 


YZB4s 


LDRPAR 248. 00003000 
SYSPAR 248. 00010000 
GEN 225. 00023300 
GEN 200. 00040000 
GEN 200. 00013500 
GEN 200. 00013500 
GEN 160. 90040000 
SYSPAR 160. 00010000 
GEN 160. 900040000 
GEN 160. 00040000 
SYSPAR 160. 00010000 
GEN 160. 00040000 
FCPPAR 149. 00051500 
GEN 145. 00015700 
GEN 145. 00016200 
GEN 140. 900053400 
GEN 140. 00023700 
GEN 130. 00020400 
SYSPAR 105. 00010000 
GEN 100. 90003100 
GEN 100. 00040000 
GEN 100. 00030000 
GEN 100. 00040000 
GEN 100. 00040000 
GEN BO. 00043000 
GEN 73. 90027000 
GEN 70. 00014200 
GEN 6S. 00036700 
GEN 65. 00057700 
GEN 65. 00025500 
GEN 61. 00040000 
GEN 60. 00051700 
GEN 50. 00055700 
GEN 50. 00040000 
GEN SO. 00040000 
GEN 50. 00031200 
GEN 30. 00014400 
GEN 50. 00123200 
GEN 50. 90030200 
GEN 30. 00040000 
GEN 50. 00010700 
GEN 50. 00040000 
CSR=176700 
CSR=172440 
C8R=177560 
CSR=160070 
CSR=160100 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL. DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER 
OFL DRIVER | 


LBO.-00156234 FIXED 


LBO.-00161016 
LBO:-00161554 
LBO:-00157424 
LBO.-00161445 
LBO;~-00160607 
LBO:-00157636 
LBO:-00157451 
LBO;-00137006 
LBO.-00161127 


LBO:-00161327 © 


LBO:-00160500 
LB0.-00157347 
LBO:-00156756 
LBO.-00157126 
LBO:-00160422 
LBO.-00160530 
LBO:.-00162070 
LBO.-00160635 
LBO.~-00157147 
LBO.-00160644 
LBO:-00157376 
LBO:-00161704 
LBO:-00160722 
LBO:-00157157 
LBO:-00160556 
LBO:-00161037 
LBO:-00156527 
LBO:-00157525 
LBO.-00161762 
LBO.-00157024 
LBO:-00161363 
LBO:-00157033 
LBO:-00156634 
LBO:-O00156654 
LBO:-00156703 
LBO:-00156737 
LBO:-00040355 
LBO:-00157472 
LBO:-00160740 
LBO:-00160707 
LBO:-00162113 


VEC=254 PRI=5 
VEC=224 PRI=5 
VEC=60 PRI=5 
VEC=300 PRI=5 
VEC=310 PRI=5 


EXAMPLE INSTALLATION 


H-14 


TTIG: YZB5: OFL DRIVER 
TT17: YZBG: OFL DRIVER 
TT20: YZB7: OFL DRIVER 
NLO: OFL DRIVER 
WTO! OFL DRIVER 
RDO: ONL DRIVER 


POOL =1200:13428.:13444. 52025 

>* DO YOU WANT TO DO SYSGEN PART 3 (BUILD UTILITY TASKS)? CY/Niin 
>ASN = 

>@ <EOF> 


2b20 fi+S4irexiie. 


xDT >: : 
RSX-11M-PLUS VO1 BL 


> 

TIM 11:30 S-DEC-681 
>TIM 

11230502 O9-DEC-61 
>SAY /WB/NOCON 


RSX-11M-PLUS VO1 BLE& 320K 
PRED DR:=SY: 
PRED DRe=LB: 
>RED DRo=SP: 
>MOU DRORSX11MPBLGE 
2@DRiC1,2I7STARTUP 
>F PLEASE NOTE 


> If you have not vet read the system release notes do go now before 
> attempting to perform a SYSGEN or utilize the new features of 
H this system. 


>* Please enter time and date (HH?MM MM/DD/YY) CSI: 11:91 
>* Please enter time and date (HH: MM MM/DD/YY) CSI: 11:31 12/9/81 
>TIME 11231 12/9/81 

SACS SY: /BLKS=1024. 

>CON ONLINE ALL 

2RUN ERRLOG 

ERL -~ ERROR LOG INITIALIZED 

>START /QUEUE/MANAGER 

> 

>INS $GMGPRT/TASK=PRT.../SLV=NO 

11:31:07 @QMG -- UNEXPECTED EXIT PROCESSOR BAPO 
>INITIALIZE/QUEUE LPGO 

INI -~- QUEUE ALREADY EXISTS 

>START/ACCOUNTING 

DINITIALIZE/PROCESSOR LPPO/FLAG:2/FORM:0/LOWER 
INI -- DEVICE DOES NOT EXIST 
>INITIALIZE/PROCESSOR BAPO 

DASSIGN/QUEUE PRINT LPPO 

ASS -- PROCESSOR DOES NOT EXIST 

>ASSIGN/QUEUE BATCH BAPO 

>@ <EOF> 


12/81 EXAMPLE INSTALLATION H-15 


12/81 


SET /UIC 
UIC=C12,2] 
@PMONBLD 
># ENTER KW11-P VECTOR ADDRESS CO R!100-774 D104]: 

>* ENTER KWi1-P CSR ADDRESS CO R2160000-177776 D:1725401: 
>* WILL THE BUFFERS BE IN A STATIC PARTITION? CY/NI:n 
>TKB @COLBLD 
>TKB @TRMBLD 
‘>TKB @COLMSGBLD 


Pa 
>? 
> 
>* 
oa 
o% 
>? 
oe 
> 
># 
> 
>* 
> 
>* 


Taskbuild the MDR, OVL & CLF Prosarams. 


EIS or FPP <FPP> [ES]: eis 
you must specify either "EIS" or "FPP" without the suotes. 
EIS or FPP <FPP> CS]: EIS 


Do you wish ta 
Do vou wish to 
Do vou wish to 


Build Overlaid 
Do you want to 


>TKB @MDREISNOV 


>8 
> 


<EOF > 


build the task OVL? CY/NIin 
build the task CLF? CY/NiIin 
build the task MDR? CY/Ni:y 


Version of MDR.TSK? CY/Nicn 
edit the MDR taskbuild command file? CY/NIcn 


EXAMPLE INSTALLATION 


H-16 


—s 


